chore: add Claude plugin config and Discord integration settings

feat: add live analyzer test and document agent workflows

Author: PaulJPhilp

.biomeignore

@@ -0,0 +1,4 @@
+# Ignore archived docs and generated files
+
+docs/archive/
+docs/archive/**

.claude-plugin/.ai-plugin-config.json

@@ -0,0 +1,18 @@
+{
+    "schema_version": "v1",
+    "name_for_human": "Effect Patterns (staging)",
+    "name_for_model": "effect_patterns_staging",
+    "description_for_human": "Search and generate Effect pattern snippets (staging).",
+    "description_for_model": "Tool for searching and generating Effect patterns. Use function-calls via the OpenAPI spec.",
+    "auth": {
+        "type": "service_http",
+        "authorization_type": "bearer"
+    },
+    "api": {
+        "type": "openapi",
+        "url": "https://YOUR-STAGING-URL.vercel.app/.well-known/openapi.json"
+    },
+    "logo_url": "https://YOUR-STAGING-URL.vercel.app/logo.png",
+    "contact_email": "ops@your-org.example",
+    "legal_info_url": "https://your-org.example/legal"
+}

.claude-plugin/plugins/effect-patterns/commands/explain.md

@@ -0,0 +1,19 @@
+---
+title: "Search Effect Patterns"
+description: "Search the Effect Patterns catalog by keyword and get short summaries."
+---
+
+Usage:
+
+- /pattern search [query]
+
+Behavior:
+
+- Query the plugin's MCP server (or local index) for pattern matches.
+- Return a short list of matching patterns (id, title, 1-line summary).
+- Show top example usage snippet.
+
+Examples:
+
+- /pattern search retry
+- /pattern search concurrency pool

.claude-plugin/plugins/effect-patterns/commands/search.md

@@ -1,108 +1,23 @@
 {
   "name": "effect-patterns",
-  "version": "0.1.0",
-  "description": "Search and generate Effect-TS patterns directly in Claude Code",
+  "version": "0.0.1",
+  "description": "Effect Patterns – search, explain and generate TypeScript Effect snippets (staging).",
+  "author": {
+    "name": "Paul J Philp",
+    "url": "https://github.com/PaulJPhilp"
+  },
   "commands": [
-    {
-      "name": "search-patterns",
-      "description": "Search for Effect patterns by keyword, category, or difficulty",
-      "endpoint": "/api/patterns",
-      "method": "GET",
-      "parameters": {
-        "q": {
-          "type": "string",
-          "description": "Search query for fuzzy matching",
-          "required": false
-        },
-        "category": {
-          "type": "string",
-          "description": "Filter by category (error-handling, concurrency, etc.)",
-          "required": false
-        },
-        "difficulty": {
-          "type": "string",
-          "description": "Filter by difficulty (beginner, intermediate, advanced)",
-          "required": false
-        },
-        "limit": {
-          "type": "number",
-          "description": "Maximum number of results to return",
-          "required": false
-        }
-      }
-    },
-    {
-      "name": "get-pattern",
-      "description": "Get full details for a specific pattern by ID",
-      "endpoint": "/api/patterns/{id}",
-      "method": "GET",
-      "parameters": {
-        "id": {
-          "type": "string",
-          "description": "Pattern ID",
-          "required": true
-        }
-      }
-    },
-    {
-      "name": "generate-snippet",
-      "description": "Generate a code snippet from a pattern with customization",
-      "endpoint": "/api/generate",
-      "method": "POST",
-      "parameters": {
-        "patternId": {
-          "type": "string",
-          "description": "ID of the pattern to generate from",
-          "required": true
-        },
-        "name": {
-          "type": "string",
-          "description": "Custom name for the generated code",
-          "required": false
-        },
-        "input": {
-          "type": "string",
-          "description": "Custom input value for the example",
-          "required": false
-        },
-        "moduleType": {
-          "type": "string",
-          "enum": ["esm", "cjs"],
-          "description": "Module type (ESM or CommonJS)",
-          "required": false
-        },
-        "effectVersion": {
-          "type": "string",
-          "description": "Effect version to target",
-          "required": false
-        }
-      }
-    },
-    {
-      "name": "trace-wiring",
-      "description": "Get examples for integrating trace IDs across platforms",
-      "endpoint": "/api/trace-wiring",
-      "method": "GET",
-      "parameters": {}
-    },
-    {
-      "name": "health-check",
-      "description": "Check if the Effect Patterns service is available",
-      "endpoint": "/api/health",
-      "method": "GET",
-      "parameters": {}
-    }
+    "./commands/search.md",
+    "./commands/explain.md"
   ],
   "agents": [
-    {
-      "name": "effect-pattern-assistant",
-      "description": "AI assistant specialized in Effect-TS patterns",
-      "systemPrompt": "You are an expert in Effect-TS patterns. Help users find, understand, and implement Effect patterns. When users ask about error handling, concurrency, or other Effect topics, search for relevant patterns and provide code examples. Always explain the pattern's purpose and use cases.",
-      "tools": [
-        "search-patterns",
-        "get-pattern",
-        "generate-snippet"
-      ]
+    "./agents/recommender.md"
+  ],
+  "mcpServers": {
+    "effect-patterns-server": {
+      "source": "http",
+      "url": "__MCP_BASE_URL__/api"
     }
-  ]
-}
+  },
+  "strict": false
+}

.claude-plugin/plugins/effect-patterns/plugin.json

@@ -1,3 +1,11 @@
 GOOGLE_AI_API_KEY=AIzaSyCGvh5ZboFDAQidomK0KUjqndlEGDE-6_k
 OPENAI_API_KEY=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
-ANTHROPIC_API_KEY=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
+ANTHROPIC_API_KEY=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
+
+# Discord Ingestion Configuration
+DISCORD_BOT_TOKEN="MTQyNjM1NDgyNDk3MDEwOTA2OQ.G4j1Pq.ky9Mhx4hyRMc0zMZW940cDnngZM4P5QjX0H73Y"
+DISCORD_CHANNEL_ID="987654321"
+DISCORD_EXPORTER_PATH="./tools/DiscordChatExporter.Cli"
+
+# Discord Integration Test Configuration
+DISCORD_TEST_CHANNEL_ID="1426382467354595333"