@hivehub/rulebook 5.8.1 → 6.0.0

package/templates/skills/modules/grafana/SKILL.md

@@ -1,338 +0,0 @@
----
-name: "Grafana"
-description: "Use MCP Grafana for metrics visualization, alerting, and observability dashboards."
-version: "1.0.0"
-category: "modules"
-author: "Rulebook"
-tags: ["modules", "mcp"]
-dependencies: []
-conflicts: []
----
-<!-- GRAFANA:START -->
-# Grafana MCP Instructions
-
-**CRITICAL**: Use MCP Grafana for metrics visualization, alerting, and observability dashboards.
-
-## Core Operations
-
-### Dashboard Management
-```typescript
-// Get dashboard
-grafana.dashboards.getDashboardByUid({ uid: 'dashboard-uid' })
-
-// Create dashboard
-grafana.dashboards.postDashboard({
-  dashboard: {
-    title: 'Application Metrics',
-    tags: ['production', 'api'],
-    timezone: 'browser',
-    panels: [
-      {
-        title: 'Request Rate',
-        type: 'graph',
-        targets: [{ expr: 'rate(http_requests_total[5m])' }]
-      }
-    ]
-  },
-  overwrite: false
-})
-
-// Update dashboard
-grafana.dashboards.postDashboard({
-  dashboard: modifiedDashboard,
-  overwrite: true
-})
-
-// Delete dashboard
-grafana.dashboards.deleteDashboardByUid({ uid: 'dashboard-uid' })
-```
-
-### Data Sources
-```typescript
-// Get data sources
-grafana.datasources.getDataSources()
-
-// Add data source
-grafana.datasources.addDataSource({
-  name: 'Prometheus',
-  type: 'prometheus',
-  url: 'http://prometheus:9090',
-  access: 'proxy',
-  isDefault: true
-})
-
-// Query data source
-grafana.datasources.queryDataSource({
-  datasourceId: 1,
-  from: Date.now() - 3600000,  // 1 hour ago
-  to: Date.now(),
-  queries: [
-    { expr: 'up', refId: 'A' }
-  ]
-})
-```
-
-### Alerts
-```typescript
-// Get alerts
-grafana.alerting.getAlerts({ state: 'alerting' })
-
-// Create alert rule
-grafana.alerting.postAlertRule({
-  title: 'High Error Rate',
-  condition: 'A',
-  data: [
-    {
-      refId: 'A',
-      queryType: '',
-      relativeTimeRange: { from: 600, to: 0 },
-      datasourceUid: 'prometheus-uid',
-      model: {
-        expr: 'rate(http_errors_total[5m]) > 0.05'
-      }
-    }
-  ],
-  noDataState: 'NoData',
-  execErrState: 'Alerting',
-  for: '5m',
-  annotations: {
-    description: 'Error rate exceeded 5%'
-  },
-  labels: { severity: 'high' }
-})
-
-// Pause alert
-grafana.alerting.pauseAlertRule({ uid: 'alert-uid', paused: true })
-```
-
-### Annotations
-```typescript
-// Create annotation
-grafana.annotations.postAnnotation({
-  dashboardUid: 'dashboard-uid',
-  time: Date.now(),
-  timeEnd: Date.now(),
-  tags: ['deployment'],
-  text: 'Deployed version 1.2.0'
-})
-
-// Get annotations
-grafana.annotations.getAnnotations({
-  from: Date.now() - 86400000,  // Last 24h
-  to: Date.now(),
-  tags: ['deployment']
-})
-```
-
-### Organizations & Users
-```typescript
-// Get organization
-grafana.orgs.getOrgByName({ orgName: 'Main Org' })
-
-// Add user
-grafana.users.createUser({
-  email: 'user@example.com',
-  login: 'username',
-  password: 'secure-password',
-  name: 'User Name'
-})
-
-// Update user permissions
-grafana.org.updateOrgUser({
-  userId: 123,
-  role: 'Editor'  // Viewer, Editor, Admin
-})
-```
-
-## Common Patterns
-
-### Deployment Tracking
-```typescript
-// Mark deployment on dashboard
-await grafana.annotations.postAnnotation({
-  time: Date.now(),
-  tags: ['deployment', 'production'],
-  text: `Deployed ${process.env.GIT_SHA}`,
-  dashboardUid: 'main-dashboard'
-})
-
-// Create snapshot after deployment
-const snapshot = await grafana.snapshots.createDashboardSnapshot({
-  dashboard: dashboard,
-  name: `Production Metrics - ${new Date().toISOString()}`,
-  expires: 86400  // 24 hours
-})
-```
-
-### Automated Dashboard Creation
-```typescript
-// Create dashboard for new service
-async function createServiceDashboard(serviceName) {
-  const dashboard = {
-    title: `${serviceName} Metrics`,
-    tags: ['microservices', serviceName],
-    panels: [
-      {
-        title: 'Request Rate',
-        type: 'graph',
-        targets: [{
-          expr: `rate(http_requests_total{service="${serviceName}"}[5m])`
-        }]
-      },
-      {
-        title: 'Error Rate',
-        type: 'graph',
-        targets: [{
-          expr: `rate(http_errors_total{service="${serviceName}"}[5m])`
-        }]
-      },
-      {
-        title: 'Response Time (p95)',
-        type: 'graph',
-        targets: [{
-          expr: `histogram_quantile(0.95, rate(http_duration_seconds_bucket{service="${serviceName}"}[5m]))`
-        }]
-      }
-    ]
-  }
-  
-  return await grafana.dashboards.postDashboard({
-    dashboard,
-    overwrite: false
-  })
-}
-```
-
-### Alert Management
-```typescript
-// Check for firing alerts
-const alerts = await grafana.alerting.getAlerts({ state: 'alerting' })
-
-if (alerts.length > 0) {
-  console.log(`${alerts.length} alerts firing:`)
-  
-  for (const alert of alerts) {
-    console.log(`- ${alert.labels.alertname}: ${alert.annotations.description}`)
-    
-    // Create incident ticket
-    await jira.issues.createIssue({
-      fields: {
-        project: { key: 'OPS' },
-        summary: `Alert: ${alert.labels.alertname}`,
-        description: alert.annotations.description,
-        issuetype: { name: 'Incident' },
-        priority: { name: alert.labels.severity === 'critical' ? 'Highest' : 'High' }
-      }
-    })
-  }
-}
-```
-
-### Metrics Reporting
-```typescript
-// Generate daily metrics report
-async function generateDailyReport() {
-  const datasourceId = 1  // Prometheus
-  const from = Date.now() - 86400000  // 24h ago
-  const to = Date.now()
-  
-  // Query metrics
-  const requestRate = await grafana.datasources.queryDataSource({
-    datasourceId,
-    from,
-    to,
-    queries: [{ expr: 'sum(rate(http_requests_total[24h]))', refId: 'A' }]
-  })
-  
-  const errorRate = await grafana.datasources.queryDataSource({
-    datasourceId,
-    from,
-    to,
-    queries: [{ expr: 'sum(rate(http_errors_total[24h]))', refId: 'A' }]
-  })
-  
-  // Create report
-  const report = {
-    date: new Date().toISOString(),
-    totalRequests: requestRate.results.A.frames[0].data.values[1][0],
-    totalErrors: errorRate.results.A.frames[0].data.values[1][0],
-    errorPercentage: (totalErrors / totalRequests * 100).toFixed(2)
-  }
-  
-  // Post to Confluence/Notion
-  await notion.pages.create({
-    parent: { database_id: reportsDbId },
-    properties: {
-      'Title': { title: [{ text: { content: `Daily Metrics - ${report.date}` } }] },
-      'Requests': { number: report.totalRequests },
-      'Errors': { number: report.totalErrors },
-      'Error Rate': { number: parseFloat(report.errorPercentage) }
-    }
-  })
-}
-```
-
-## Best Practices
-
-✅ **DO:**
-- Use dashboard folders for organization
-- Tag dashboards appropriately
-- Set up proper alert thresholds
-- Use variables for flexibility
-- Create snapshots before changes
-- Document dashboard purpose
-- Use templating for multi-instance dashboards
-
-❌ **DON'T:**
-- Create duplicate dashboards
-- Set alerts without testing
-- Ignore alert fatigue
-- Hardcode dashboard IDs
-- Skip dashboard backups
-- Over-complicate queries
-
-## Configuration
-
-```json
-{
-  "mcpServers": {
-    "grafana": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-grafana"],
-      "env": {
-        "GRAFANA_URL": "http://grafana:3000",
-        "GRAFANA_API_KEY": "your-api-key",
-        "GRAFANA_ORG_ID": "1"
-      }
-    }
-  }
-}
-```
-
-**Setup:**
-1. Create API key: Configuration → API Keys → Add API key
-2. Grant appropriate permissions (Admin for management, Viewer for read-only)
-3. Store securely
-
-## Integration with CI/CD
-
-```typescript
-// Add deployment annotation on successful deploy
-if (deploymentSuccess) {
-  await grafana.annotations.postAnnotation({
-    time: Date.now(),
-    tags: ['deployment', process.env.ENVIRONMENT],
-    text: `Deployed ${process.env.GIT_SHA} to ${process.env.ENVIRONMENT}`,
-    dashboardUid: process.env.GRAFANA_DASHBOARD_UID
-  })
-}
-
-// Check alerts before deployment
-const alerts = await grafana.alerting.getAlerts({ state: 'alerting' })
-if (alerts.length > 0) {
-  console.warn('⚠️  Active alerts detected. Deployment may be risky.')
-}
-```
-
-<!-- GRAFANA:END -->
-

package/templates/skills/modules/memory/SKILL.md

@@ -1,73 +0,0 @@
----
-name: "Memory"
-description: "The rulebook memory system provides persistent context across AI sessions using hybrid search (BM25 keyword + HNSW vector) with zero native dependenci"
-version: "1.0.0"
-category: "modules"
-author: "Rulebook"
-tags: ["modules", "mcp"]
-dependencies: []
-conflicts: []
----
-<!-- MEMORY:START -->
-## Persistent Memory System
-
-The rulebook memory system provides persistent context across AI sessions using hybrid search (BM25 keyword + HNSW vector) with zero native dependencies.
-
-### 3-Layer Search Pattern (Token-Efficient)
-
-**Layer 1 — Compact Search**: Get brief results to scan relevance.
-```
-rulebook_memory_search({ query: "authentication bug", mode: "hybrid", limit: 10 })
-→ Returns: { id, title, type, score, matchType, createdAt } per result (~50 tokens each)
-```
-
-**Layer 2 — Timeline**: Get chronological context around a memory.
-```
-rulebook_memory_timeline({ memoryId: "abc-123", window: 5 })
-→ Returns: 5 memories before + anchor + 5 memories after (~200 tokens each)
-```
-
-**Layer 3 — Full Details**: Get complete content only for selected memories.
-```
-rulebook_memory_get({ ids: ["abc-123", "def-456"] })
-→ Returns: Full memory objects with content (~500-1000 tokens each)
-```
-
-### Memory Types
-
-- **bugfix**: Bug fixes, error resolutions
-- **feature**: New features, additions
-- **refactor**: Code restructuring
-- **decision**: Architectural decisions (protected from eviction)
-- **discovery**: Insights and learnings
-- **change**: Updates and modifications
-- **observation**: General observations
-
-### CLI Commands
-
-```bash
-rulebook memory search "authentication bug"     # Hybrid search
-rulebook memory save "Decided to use sql.js" --type decision --title "DB Choice"
-rulebook memory list --limit 10                  # Recent memories
-rulebook memory stats                            # Database statistics
-rulebook memory cleanup --force                  # Force eviction
-rulebook memory export --format json             # Export all memories
-```
-
-### Configuration (.rulebook)
-
-```json
-{
-  "memory": {
-    "enabled": true,
-    "dbPath": ".rulebook-memory/memory.db",
-    "maxSizeBytes": 524288000,
-    "vectorDimensions": 256
-  }
-}
-```
-
-### Privacy
-
-Content between `<private>` and `</private>` tags is automatically stripped before storage.
-<!-- MEMORY:END -->

package/templates/skills/modules/notion/SKILL.md

@@ -1,257 +0,0 @@
----
-name: "Notion"
-description: "Use MCP Notion for documentation, task tracking, and knowledge management."
-version: "1.0.0"
-category: "modules"
-author: "Rulebook"
-tags: ["modules", "mcp"]
-dependencies: []
-conflicts: []
----
-<!-- NOTION:START -->
-# Notion MCP Instructions
-
-**CRITICAL**: Use MCP Notion for documentation, task tracking, and knowledge management.
-
-## Core Operations
-
-### Database Queries
-```typescript
-// Query database
-notion.databases.query({
-  database_id: 'database-id',
-  filter: {
-    property: 'Status',
-    select: { equals: 'In Progress' }
-  },
-  sorts: [{ property: 'Created', direction: 'descending' }]
-})
-
-// Get database
-notion.databases.retrieve({ database_id: 'database-id' })
-```
-
-### Page Operations
-```typescript
-// Create page
-notion.pages.create({
-  parent: { database_id: 'database-id' },
-  properties: {
-    'Name': { title: [{ text: { content: 'New Task' } }] },
-    'Status': { select: { name: 'To Do' } },
-    'Priority': { select: { name: 'High' } }
-  }
-})
-
-// Update page
-notion.pages.update({
-  page_id: 'page-id',
-  properties: {
-    'Status': { select: { name: 'Done' } }
-  }
-})
-
-// Get page
-notion.pages.retrieve({ page_id: 'page-id' })
-```
-
-### Block Operations
-```typescript
-// Get blocks
-notion.blocks.children.list({ block_id: 'page-id' })
-
-// Append blocks
-notion.blocks.children.append({
-  block_id: 'page-id',
-  children: [
-    {
-      object: 'block',
-      type: 'heading_2',
-      heading_2: {
-        rich_text: [{ type: 'text', text: { content: 'Section Title' } }]
-      }
-    },
-    {
-      object: 'block',
-      type: 'paragraph',
-      paragraph: {
-        rich_text: [{ type: 'text', text: { content: 'Content here' } }]
-      }
-    }
-  ]
-})
-```
-
-### Search
-```typescript
-// Search all content
-notion.search({
-  query: 'search term',
-  filter: { property: 'object', value: 'page' },
-  sort: { direction: 'descending', timestamp: 'last_edited_time' }
-})
-```
-
-## Common Patterns
-
-### Task Management
-```typescript
-// Create task
-await notion.pages.create({
-  parent: { database_id: tasksDbId },
-  properties: {
-    'Task': { title: [{ text: { content: 'Implement feature X' } }] },
-    'Status': { select: { name: 'To Do' } },
-    'Assignee': { people: [{ id: userId }] },
-    'Due Date': { date: { start: '2024-12-31' } }
-  }
-})
-
-// Update task status
-await notion.pages.update({
-  page_id: taskId,
-  properties: {
-    'Status': { select: { name: 'In Progress' } },
-    'Started': { date: { start: new Date().toISOString() } }
-  }
-})
-
-// Complete task
-await notion.pages.update({
-  page_id: taskId,
-  properties: {
-    'Status': { select: { name: 'Done' } },
-    'Completed': { date: { start: new Date().toISOString() } }
-  }
-})
-```
-
-### Documentation Generation
-```typescript
-// Create documentation page
-const page = await notion.pages.create({
-  parent: { database_id: docsDbId },
-  properties: {
-    'Title': { title: [{ text: { content: 'API Documentation' } }] },
-    'Category': { select: { name: 'Technical' } }
-  }
-})
-
-// Add content blocks
-await notion.blocks.children.append({
-  block_id: page.id,
-  children: [
-    { type: 'heading_1', heading_1: { rich_text: [{ text: { content: 'API Reference' } }] } },
-    { type: 'paragraph', paragraph: { rich_text: [{ text: { content: 'Endpoints overview...' } }] } },
-    { type: 'code', code: { 
-      language: 'typescript',
-      rich_text: [{ text: { content: 'const api = new API()' } }]
-    }}
-  ]
-})
-```
-
-### Meeting Notes
-```typescript
-// Create meeting notes
-await notion.pages.create({
-  parent: { database_id: meetingsDbId },
-  properties: {
-    'Title': { title: [{ text: { content: 'Sprint Planning - Jan 2024' } }] },
-    'Date': { date: { start: '2024-01-15' } },
-    'Attendees': { people: attendeeIds }
-  }
-})
-
-// Add agenda and notes
-await notion.blocks.children.append({
-  block_id: pageId,
-  children: [
-    { type: 'heading_2', heading_2: { rich_text: [{ text: { content: 'Agenda' } }] } },
-    { type: 'bulleted_list_item', bulleted_list_item: { rich_text: [{ text: { content: 'Review last sprint' } }] } },
-    { type: 'bulleted_list_item', bulleted_list_item: { rich_text: [{ text: { content: 'Plan next sprint' } }] } },
-    { type: 'heading_2', heading_2: { rich_text: [{ text: { content: 'Action Items' } }] } }
-  ]
-})
-```
-
-## Best Practices
-
-✅ **DO:**
-- Use databases for structured data
-- Cache database schemas
-- Batch operations when possible
-- Handle rate limits (3 requests/second)
-- Use rich text for formatting
-- Archive instead of delete
-
-❌ **DON'T:**
-- Make excessive API calls
-- Ignore rate limiting
-- Store large binary files
-- Skip error handling
-- Hardcode database IDs
-
-## Configuration
-
-```json
-{
-  "mcpServers": {
-    "notion": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-notion"],
-      "env": {
-        "NOTION_API_KEY": "secret_xxx",
-        "NOTION_VERSION": "2022-06-28"
-      }
-    }
-  }
-}
-```
-
-**Setup:**
-1. Create integration at https://www.notion.so/my-integrations
-2. Copy internal integration token
-3. Share databases/pages with integration
-4. Use token as `NOTION_API_KEY`
-
-## Integration Patterns
-
-### Sync Tasks from Code
-```typescript
-// Sync OpenSpec tasks to Notion
-const tasks = parseOpenSpecTasks('openspec/changes/my-feature/tasks.md')
-
-for (const task of tasks) {
-  await notion.pages.create({
-    parent: { database_id: tasksDbId },
-    properties: {
-      'Task': { title: [{ text: { content: task.title } }] },
-      'Status': { select: { name: task.completed ? 'Done' : 'To Do' } },
-      'Source': { select: { name: 'OpenSpec' } }
-    }
-  })
-}
-```
-
-### Generate Changelog
-```typescript
-// Query completed tasks
-const completed = await notion.databases.query({
-  database_id: tasksDbId,
-  filter: {
-    and: [
-      { property: 'Status', select: { equals: 'Done' } },
-      { property: 'Completed', date: { after: '2024-01-01' } }
-    ]
-  }
-})
-
-// Generate CHANGELOG.md entries
-const entries = completed.results.map(task => 
-  `- ${task.properties.Task.title[0].plain_text}`
-)
-```
-
-<!-- NOTION:END -->
-