mirror of
https://github.com/claude-did-this/claude-hub.git
synced 2026-02-14 19:30:02 +01:00
feat: Implement Claude orchestration provider for parallel session management (#171)
* feat: Implement Claude orchestration provider for parallel session management - Add ClaudeWebhookProvider implementing the webhook provider interface - Create orchestration system for running multiple Claude containers in parallel - Implement smart task decomposition to break complex projects into workstreams - Add session management with dependency tracking between sessions - Support multiple execution strategies (parallel, sequential, wait_for_core) - Create comprehensive test suite for all components - Add documentation for Claude orchestration API and usage This enables super-charged Claude capabilities for the MCP hackathon by allowing multiple Claude instances to work on different aspects of a project simultaneously, with intelligent coordination and result aggregation. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: Add session management endpoints for MCP integration - Add SessionHandler for individual session CRUD operations - Create endpoints: session.create, session.get, session.list, session.start, session.output - Fix Claude invocation in Docker containers using proper claude chat command - Add volume mounts for persistent storage across session lifecycle - Simplify OrchestrationHandler to create single coordination sessions - Update documentation with comprehensive MCP integration examples - Add comprehensive unit and integration tests for new endpoints - Support dependencies and automatic session queuing/starting This enables Claude Desktop to orchestrate multiple Claude Code sessions via MCP Server tools. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: Update ClaudeWebhookProvider validation for session endpoints - Make project fields optional for session management operations - Add validation for session.create requiring session field - Update tests to match new validation rules - Fix failing CI tests 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: Use Promise.reject for validation errors in parsePayload - Convert synchronous throws to Promise.reject for async consistency - Fixes failing unit tests expecting rejected promises 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: Mock SessionManager in integration tests to avoid Docker calls in CI - Add SessionManager mock to prevent Docker operations during tests - Fix claude-webhook.test.ts to use proper test setup and payload structure - Ensure all integration tests can run without Docker dependency - Fix payload structure to include 'data' wrapper 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: Mock child_process to prevent Docker calls in CI tests - Mock execSync and spawn at child_process level to prevent any Docker commands - This ensures tests work in CI environment without Docker - Tests now pass both locally and in CI Docker build 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: Address PR review comments and fix linter warnings - Move @types/uuid to devDependencies - Replace timestamp+Math.random with crypto.randomUUID() for better uniqueness - Extract magic number into EXTRA_SESSIONS_COUNT constant - Update determineStrategy return type to use literal union - Fix unnecessary optional chaining warnings - Handle undefined labels in GitHub transformers - Make TaskDecomposer.decompose synchronous - Add proper eslint-disable comments for intentional sync methods - Fix all TypeScript and formatting issues * fix: Mock SessionManager in integration tests to prevent Docker calls in CI - Add SessionManager mocks to claude-session.test.ts - Add SessionManager mocks to claude-webhook.test.ts - Prevents 500 errors when running tests in CI without Docker - All integration tests now pass without requiring Docker runtime * fix: Run only unit tests in Docker builds to avoid Docker-in-Docker issues - Change test stage to run 'npm run test:unit' instead of 'npm test' - Skips integration tests that require Docker runtime - Prevents CI failures in Docker container builds - Integration tests still run in regular CI workflow * fix: Use Dockerfile CMD for tests in Docker build CI - Remove explicit 'npm test' command from docker run - Let Docker use the CMD defined in Dockerfile (npm run test:unit) - This ensures consistency and runs only unit tests in Docker builds --------- Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Cheffromspace
5
.github/workflows/docker-publish.yml
vendored
5
.github/workflows/docker-publish.yml
vendored
@@ -75,13 +75,12 @@ jobs:
|
|||||||
# Build the test stage
|
# Build the test stage
|
||||||
docker build --target test -t ${{ env.IMAGE_NAME }}:test-${{ github.sha }} -f Dockerfile .
|
docker build --target test -t ${{ env.IMAGE_NAME }}:test-${{ github.sha }} -f Dockerfile .
|
||||||
|
|
||||||
# Run tests in container
|
# Run tests in container (using default CMD from Dockerfile which runs unit tests only)
|
||||||
docker run --rm \
|
docker run --rm \
|
||||||
-e CI=true \
|
-e CI=true \
|
||||||
-e NODE_ENV=test \
|
-e NODE_ENV=test \
|
||||||
-v ${{ github.workspace }}/coverage:/app/coverage \
|
-v ${{ github.workspace }}/coverage:/app/coverage \
|
||||||
${{ env.IMAGE_NAME }}:test-${{ github.sha }} \
|
${{ env.IMAGE_NAME }}:test-${{ github.sha }}
|
||||||
npm test
|
|
||||||
|
|
||||||
# Build production image for smoke test
|
# Build production image for smoke test
|
||||||
docker build --target production -t ${{ env.IMAGE_NAME }}:pr-${{ github.event.number }} -f Dockerfile .
|
docker build --target production -t ${{ env.IMAGE_NAME }}:pr-${{ github.event.number }} -f Dockerfile .
|
||||||
|
|||||||
@@ -54,8 +54,8 @@ COPY --from=builder /app/dist ./dist
|
|||||||
# Set test environment
|
# Set test environment
|
||||||
ENV NODE_ENV=test
|
ENV NODE_ENV=test
|
||||||
|
|
||||||
# Run tests by default in this stage
|
# Run only unit tests in Docker builds (skip integration tests that require Docker)
|
||||||
CMD ["npm", "test"]
|
CMD ["npm", "run", "test:unit"]
|
||||||
|
|
||||||
# Production stage - minimal runtime image
|
# Production stage - minimal runtime image
|
||||||
FROM node:24-slim AS production
|
FROM node:24-slim AS production
|
||||||
|
|||||||
@@ -77,6 +77,13 @@ That's it! Your bot is ready to use. See the **[complete quickstart guide](./QUI
|
|||||||
- **Context-aware**: Claude understands your entire repository structure and development patterns
|
- **Context-aware**: Claude understands your entire repository structure and development patterns
|
||||||
- **Stateless execution**: Each request runs in isolated Docker containers
|
- **Stateless execution**: Each request runs in isolated Docker containers
|
||||||
|
|
||||||
|
### Claude Orchestration (NEW) 🎭
|
||||||
|
- **Parallel Claude Sessions**: Run multiple Claude containers concurrently for complex tasks
|
||||||
|
- **Smart Task Decomposition**: Automatically breaks down projects into parallel workstreams
|
||||||
|
- **Dependency Management**: Sessions wait for prerequisites before starting
|
||||||
|
- **MCP Integration**: Built for the MCP hackathon to showcase super-charged Claude capabilities
|
||||||
|
- **See [Claude Orchestration Documentation](./docs/claude-orchestration.md) for details**
|
||||||
|
|
||||||
### Performance Architecture ⚡
|
### Performance Architecture ⚡
|
||||||
- Parallel test execution with strategic runner distribution
|
- Parallel test execution with strategic runner distribution
|
||||||
- Conditional Docker builds (only when code changes)
|
- Conditional Docker builds (only when code changes)
|
||||||
|
|||||||
524
docs/claude-orchestration.md
Normal file
524
docs/claude-orchestration.md
Normal file
@@ -0,0 +1,524 @@
|
|||||||
|
# Claude Orchestration Provider
|
||||||
|
|
||||||
|
The Claude orchestration provider enables parallel execution of multiple Claude Code containers to solve complex tasks. This is designed for the MCP (Model Context Protocol) hackathon to demonstrate super-charged Claude capabilities.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
The orchestration system provides REST endpoints that can be wrapped as MCP Server tools, allowing Claude Desktop (or other MCP clients) to:
|
||||||
|
- Create and manage individual Claude Code sessions
|
||||||
|
- Start sessions with specific requirements and dependencies
|
||||||
|
- Monitor session status and retrieve outputs
|
||||||
|
- Orchestrate complex multi-session workflows intelligently
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
POST /api/webhooks/claude
|
||||||
|
├── ClaudeWebhookProvider (webhook handling)
|
||||||
|
├── OrchestrationHandler (orchestration logic)
|
||||||
|
├── SessionManager (container lifecycle)
|
||||||
|
└── TaskDecomposer (task analysis)
|
||||||
|
```
|
||||||
|
|
||||||
|
## API Endpoints
|
||||||
|
|
||||||
|
### Session Management Endpoints
|
||||||
|
|
||||||
|
All endpoints use the base URL: `POST /api/webhooks/claude`
|
||||||
|
|
||||||
|
**Headers (for all requests):**
|
||||||
|
```
|
||||||
|
Authorization: Bearer <CLAUDE_WEBHOOK_SECRET>
|
||||||
|
Content-Type: application/json
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 1. Create Session
|
||||||
|
|
||||||
|
Create a new Claude Code session without starting it.
|
||||||
|
|
||||||
|
**Request Body:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": {
|
||||||
|
"type": "session.create",
|
||||||
|
"session": {
|
||||||
|
"type": "implementation",
|
||||||
|
"project": {
|
||||||
|
"repository": "owner/repo",
|
||||||
|
"branch": "feature-branch",
|
||||||
|
"requirements": "Implement user authentication with JWT",
|
||||||
|
"context": "Use existing Express framework"
|
||||||
|
},
|
||||||
|
"dependencies": []
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"success": true,
|
||||||
|
"message": "Session created successfully",
|
||||||
|
"data": {
|
||||||
|
"session": {
|
||||||
|
"id": "uuid-123",
|
||||||
|
"type": "implementation",
|
||||||
|
"status": "initializing",
|
||||||
|
"containerId": "claude-implementation-abc123",
|
||||||
|
"project": { ... },
|
||||||
|
"dependencies": []
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. Start Session
|
||||||
|
|
||||||
|
Start a previously created session or queue it if dependencies aren't met.
|
||||||
|
|
||||||
|
**Request Body:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": {
|
||||||
|
"type": "session.start",
|
||||||
|
"sessionId": "uuid-123"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. Get Session Status
|
||||||
|
|
||||||
|
Retrieve current status and details of a session.
|
||||||
|
|
||||||
|
**Request Body:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": {
|
||||||
|
"type": "session.get",
|
||||||
|
"sessionId": "uuid-123"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 4. Get Session Output
|
||||||
|
|
||||||
|
Retrieve the output and artifacts from a completed session.
|
||||||
|
|
||||||
|
**Request Body:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": {
|
||||||
|
"type": "session.output",
|
||||||
|
"sessionId": "uuid-123"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"success": true,
|
||||||
|
"data": {
|
||||||
|
"sessionId": "uuid-123",
|
||||||
|
"status": "completed",
|
||||||
|
"output": {
|
||||||
|
"logs": ["Created file: src/auth.js", "Implemented JWT validation"],
|
||||||
|
"artifacts": [
|
||||||
|
{ "type": "file", "path": "src/auth.js" },
|
||||||
|
{ "type": "commit", "sha": "abc123def" }
|
||||||
|
],
|
||||||
|
"summary": "Implemented JWT authentication middleware",
|
||||||
|
"nextSteps": ["Add refresh token support", "Implement rate limiting"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5. List Sessions
|
||||||
|
|
||||||
|
List all sessions or filter by orchestration ID.
|
||||||
|
|
||||||
|
**Request Body:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": {
|
||||||
|
"type": "session.list",
|
||||||
|
"orchestrationId": "orch-uuid-456" // optional
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Orchestration Endpoint (Simplified)
|
||||||
|
|
||||||
|
Create a single orchestration session that can coordinate other sessions via MCP tools.
|
||||||
|
|
||||||
|
**Request Body:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": {
|
||||||
|
"type": "orchestrate",
|
||||||
|
"sessionType": "coordination",
|
||||||
|
"autoStart": false,
|
||||||
|
"project": {
|
||||||
|
"repository": "owner/repo",
|
||||||
|
"requirements": "Orchestrate building a full-stack application with authentication"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"message": "Webhook processed",
|
||||||
|
"event": "orchestrate",
|
||||||
|
"handlerCount": 1,
|
||||||
|
"results": [{
|
||||||
|
"success": true,
|
||||||
|
"message": "Orchestration initiated successfully",
|
||||||
|
"data": {
|
||||||
|
"orchestrationId": "uuid",
|
||||||
|
"status": "initiated",
|
||||||
|
"sessions": [
|
||||||
|
{
|
||||||
|
"id": "uuid-analysis",
|
||||||
|
"type": "analysis",
|
||||||
|
"status": "running",
|
||||||
|
"containerId": "claude-analysis-xxxxx",
|
||||||
|
"dependencies": []
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "uuid-impl-0",
|
||||||
|
"type": "implementation",
|
||||||
|
"status": "pending",
|
||||||
|
"containerId": "claude-implementation-xxxxx",
|
||||||
|
"dependencies": ["uuid-analysis"]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"summary": "Started 4 Claude sessions for owner/repo"
|
||||||
|
}
|
||||||
|
}]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
### Environment Variables
|
||||||
|
|
||||||
|
- `CLAUDE_WEBHOOK_SECRET`: Bearer token for webhook authentication
|
||||||
|
- `CLAUDE_CONTAINER_IMAGE`: Docker image for Claude Code (default: `claudecode:latest`)
|
||||||
|
- `GITHUB_TOKEN`: GitHub access token for repository operations
|
||||||
|
- `ANTHROPIC_API_KEY`: Anthropic API key for Claude access
|
||||||
|
|
||||||
|
### Strategy Options
|
||||||
|
|
||||||
|
#### Dependency Modes
|
||||||
|
|
||||||
|
- **`parallel`**: Start all independent sessions simultaneously
|
||||||
|
- **`sequential`**: Start sessions one by one in order
|
||||||
|
- **`wait_for_core`**: Start analysis first, then implementation in parallel, then testing/review
|
||||||
|
|
||||||
|
#### Session Types
|
||||||
|
|
||||||
|
- **`analysis`**: Analyze project and create implementation plan
|
||||||
|
- **`implementation`**: Write code based on requirements
|
||||||
|
- **`testing`**: Create comprehensive tests
|
||||||
|
- **`review`**: Review code and provide feedback
|
||||||
|
- **`coordination`**: Meta-session for orchestrating others
|
||||||
|
|
||||||
|
## Task Decomposition
|
||||||
|
|
||||||
|
The system automatically analyzes requirements to identify components:
|
||||||
|
|
||||||
|
- **API/Backend**: REST endpoints, GraphQL, services
|
||||||
|
- **Frontend**: UI, React, Vue, Angular components
|
||||||
|
- **Authentication**: JWT, OAuth, security features
|
||||||
|
- **Database**: Models, schemas, migrations
|
||||||
|
- **Testing**: Unit tests, integration tests
|
||||||
|
- **Deployment**: Docker, Kubernetes, CI/CD
|
||||||
|
|
||||||
|
Dependencies are automatically determined based on component relationships.
|
||||||
|
|
||||||
|
## Session Management
|
||||||
|
|
||||||
|
Each session runs in an isolated Docker container with:
|
||||||
|
- Dedicated Claude Code instance
|
||||||
|
- Access to repository via GitHub token
|
||||||
|
- Environment variables for configuration
|
||||||
|
- Automatic cleanup on completion
|
||||||
|
|
||||||
|
## Example Use Cases with MCP
|
||||||
|
|
||||||
|
### 1. Full-Stack Application Development
|
||||||
|
|
||||||
|
Claude Desktop orchestrating a complete application build:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Claude Desktop's orchestration logic (pseudocode)
|
||||||
|
async function buildFullStackApp(repo: string) {
|
||||||
|
// 1. Create analysis session
|
||||||
|
const analysisSession = await createClaudeSession({
|
||||||
|
type: "analysis",
|
||||||
|
repository: repo,
|
||||||
|
requirements: "Analyze requirements and create architecture plan for task management app"
|
||||||
|
});
|
||||||
|
|
||||||
|
await startClaudeSession(analysisSession.id);
|
||||||
|
const analysisResult = await waitForCompletion(analysisSession.id);
|
||||||
|
|
||||||
|
// 2. Create parallel implementation sessions based on analysis
|
||||||
|
const sessions = await Promise.all([
|
||||||
|
createClaudeSession({
|
||||||
|
type: "implementation",
|
||||||
|
repository: repo,
|
||||||
|
requirements: "Implement Express backend with PostgreSQL",
|
||||||
|
dependencies: [analysisSession.id]
|
||||||
|
}),
|
||||||
|
createClaudeSession({
|
||||||
|
type: "implementation",
|
||||||
|
repository: repo,
|
||||||
|
requirements: "Implement React frontend",
|
||||||
|
dependencies: [analysisSession.id]
|
||||||
|
}),
|
||||||
|
createClaudeSession({
|
||||||
|
type: "implementation",
|
||||||
|
repository: repo,
|
||||||
|
requirements: "Implement JWT authentication",
|
||||||
|
dependencies: [analysisSession.id]
|
||||||
|
})
|
||||||
|
]);
|
||||||
|
|
||||||
|
// 3. Start all implementation sessions
|
||||||
|
await Promise.all(sessions.map(s => startClaudeSession(s.id)));
|
||||||
|
|
||||||
|
// 4. Create testing session after implementations complete
|
||||||
|
const testSession = await createClaudeSession({
|
||||||
|
type: "testing",
|
||||||
|
repository: repo,
|
||||||
|
requirements: "Write comprehensive tests for all components",
|
||||||
|
dependencies: sessions.map(s => s.id)
|
||||||
|
});
|
||||||
|
|
||||||
|
// 5. Monitor and aggregate results
|
||||||
|
const results = await gatherAllResults([...sessions, testSession]);
|
||||||
|
return synthesizeResults(results);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Intelligent Bug Fix Workflow
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Claude Desktop adaptively handling a bug fix
|
||||||
|
async function fixBugWithTests(repo: string, issueDescription: string) {
|
||||||
|
// 1. Analyze the bug
|
||||||
|
const analysisSession = await createClaudeSession({
|
||||||
|
type: "analysis",
|
||||||
|
repository: repo,
|
||||||
|
requirements: `Analyze bug: ${issueDescription}`
|
||||||
|
});
|
||||||
|
|
||||||
|
const analysis = await runAndGetOutput(analysisSession.id);
|
||||||
|
|
||||||
|
// 2. Decide strategy based on analysis
|
||||||
|
if (analysis.complexity === "high") {
|
||||||
|
// Complex bug: separate diagnosis and fix sessions
|
||||||
|
await runDiagnosisFirst(repo, analysis);
|
||||||
|
} else {
|
||||||
|
// Simple bug: fix and test in parallel
|
||||||
|
await runFixAndTestParallel(repo, analysis);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Progressive Enhancement Pattern
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Claude Desktop implementing features progressively
|
||||||
|
async function enhanceAPI(repo: string, features: string[]) {
|
||||||
|
let previousSessionId = null;
|
||||||
|
|
||||||
|
for (const feature of features) {
|
||||||
|
const session = await createClaudeSession({
|
||||||
|
type: "implementation",
|
||||||
|
repository: repo,
|
||||||
|
requirements: `Add ${feature} to the API`,
|
||||||
|
dependencies: previousSessionId ? [previousSessionId] : []
|
||||||
|
});
|
||||||
|
|
||||||
|
await startClaudeSession(session.id);
|
||||||
|
await waitForCompletion(session.id);
|
||||||
|
|
||||||
|
// Run tests after each feature
|
||||||
|
const testSession = await createClaudeSession({
|
||||||
|
type: "testing",
|
||||||
|
repository: repo,
|
||||||
|
requirements: `Test ${feature} implementation`,
|
||||||
|
dependencies: [session.id]
|
||||||
|
});
|
||||||
|
|
||||||
|
await runAndVerify(testSession.id);
|
||||||
|
previousSessionId = session.id;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## MCP Integration Guide
|
||||||
|
|
||||||
|
### Overview
|
||||||
|
|
||||||
|
The Claude orchestration system is designed to be wrapped as MCP Server tools, allowing Claude Desktop to orchestrate multiple Claude Code sessions intelligently.
|
||||||
|
|
||||||
|
### MCP Server Tool Examples
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Example MCP Server tool definitions
|
||||||
|
const tools = [
|
||||||
|
{
|
||||||
|
name: "create_claude_session",
|
||||||
|
description: "Create a new Claude Code session for a specific task",
|
||||||
|
inputSchema: {
|
||||||
|
type: "object",
|
||||||
|
properties: {
|
||||||
|
sessionType: {
|
||||||
|
type: "string",
|
||||||
|
enum: ["analysis", "implementation", "testing", "review", "coordination"]
|
||||||
|
},
|
||||||
|
repository: { type: "string" },
|
||||||
|
requirements: { type: "string" },
|
||||||
|
dependencies: { type: "array", items: { type: "string" } }
|
||||||
|
},
|
||||||
|
required: ["sessionType", "repository", "requirements"]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: "start_claude_session",
|
||||||
|
description: "Start a Claude Code session",
|
||||||
|
inputSchema: {
|
||||||
|
type: "object",
|
||||||
|
properties: {
|
||||||
|
sessionId: { type: "string" }
|
||||||
|
},
|
||||||
|
required: ["sessionId"]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: "get_session_output",
|
||||||
|
description: "Get the output from a Claude Code session",
|
||||||
|
inputSchema: {
|
||||||
|
type: "object",
|
||||||
|
properties: {
|
||||||
|
sessionId: { type: "string" }
|
||||||
|
},
|
||||||
|
required: ["sessionId"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
### Orchestration Workflow Example
|
||||||
|
|
||||||
|
Claude Desktop can use these tools to orchestrate complex tasks:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Claude Desktop Orchestration Example
|
||||||
|
|
||||||
|
1. User: "Build a REST API with authentication"
|
||||||
|
|
||||||
|
2. Claude Desktop thinks:
|
||||||
|
- Need to analyze requirements first
|
||||||
|
- Then implement API and auth in parallel
|
||||||
|
- Finally run tests
|
||||||
|
|
||||||
|
3. Claude Desktop executes:
|
||||||
|
a. create_claude_session(type="analysis", repo="user/api", requirements="Analyze and plan REST API with JWT auth")
|
||||||
|
b. start_claude_session(sessionId="analysis-123")
|
||||||
|
c. Wait for completion...
|
||||||
|
d. get_session_output(sessionId="analysis-123")
|
||||||
|
|
||||||
|
e. Based on analysis output:
|
||||||
|
- create_claude_session(type="implementation", requirements="Implement REST endpoints")
|
||||||
|
- create_claude_session(type="implementation", requirements="Implement JWT authentication")
|
||||||
|
|
||||||
|
f. Start both implementation sessions in parallel
|
||||||
|
g. Monitor progress and aggregate results
|
||||||
|
h. Create and run testing session with dependencies
|
||||||
|
```
|
||||||
|
|
||||||
|
### Benefits of MCP Integration
|
||||||
|
|
||||||
|
- **Intelligent Orchestration**: Claude Desktop can dynamically decide how to break down tasks
|
||||||
|
- **Adaptive Workflow**: Can adjust strategy based on intermediate results
|
||||||
|
- **Parallel Execution**: Run multiple specialized Claude instances simultaneously
|
||||||
|
- **Context Preservation**: Each session maintains its own context and state
|
||||||
|
- **Result Aggregation**: Claude Desktop can synthesize outputs from all sessions
|
||||||
|
|
||||||
|
## Security Considerations
|
||||||
|
|
||||||
|
- Bearer token authentication required for all endpoints
|
||||||
|
- Each session runs in isolated Docker container
|
||||||
|
- No direct access to host system
|
||||||
|
- Environment variables sanitized before container creation
|
||||||
|
- Automatic container cleanup on completion
|
||||||
|
- Volume mounts isolated per session
|
||||||
|
|
||||||
|
## Implementation Details
|
||||||
|
|
||||||
|
### Session Lifecycle
|
||||||
|
|
||||||
|
1. **Creation**: Container created but not started
|
||||||
|
2. **Initialization**: Container started, Claude Code preparing
|
||||||
|
3. **Running**: Claude actively working on the task
|
||||||
|
4. **Completed/Failed**: Task finished, output available
|
||||||
|
5. **Cleanup**: Container removed, volumes optionally preserved
|
||||||
|
|
||||||
|
### Dependency Management
|
||||||
|
|
||||||
|
Sessions can declare dependencies on other sessions:
|
||||||
|
- Dependent sessions wait in queue until dependencies complete
|
||||||
|
- Automatic start when all dependencies are satisfied
|
||||||
|
- Failure of dependency marks dependent sessions as blocked
|
||||||
|
|
||||||
|
### Resource Management
|
||||||
|
|
||||||
|
- Docker volumes for persistent storage across session lifecycle
|
||||||
|
- Separate volumes for project files and Claude configuration
|
||||||
|
- Automatic cleanup of orphaned containers
|
||||||
|
- Resource limits can be configured per session type
|
||||||
|
|
||||||
|
## Best Practices for MCP Integration
|
||||||
|
|
||||||
|
1. **Session Granularity**: Create focused sessions with clear, specific requirements
|
||||||
|
2. **Dependency Design**: Use dependencies to ensure proper execution order
|
||||||
|
3. **Error Handling**: Check session status before retrieving output
|
||||||
|
4. **Resource Awareness**: Limit parallel sessions based on available resources
|
||||||
|
5. **Progress Monitoring**: Poll session status at reasonable intervals
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Common Issues
|
||||||
|
|
||||||
|
1. **Session Stuck in Initializing**
|
||||||
|
- Check Docker daemon is running
|
||||||
|
- Verify Claude container image exists
|
||||||
|
- Check container logs for startup errors
|
||||||
|
|
||||||
|
2. **Dependencies Not Met**
|
||||||
|
- Verify dependency session IDs are correct
|
||||||
|
- Check if dependency sessions completed successfully
|
||||||
|
- Use session.list to see all session statuses
|
||||||
|
|
||||||
|
3. **No Output Available**
|
||||||
|
- Ensure session completed successfully
|
||||||
|
- Check if Claude produced any output
|
||||||
|
- Review session logs for errors
|
||||||
|
|
||||||
|
## Future Enhancements
|
||||||
|
|
||||||
|
- WebSocket support for real-time session updates
|
||||||
|
- Session templates for common workflows
|
||||||
|
- Resource pooling for faster container startup
|
||||||
|
- Inter-session communication channels
|
||||||
|
- Session result caching and replay
|
||||||
|
- Advanced scheduling algorithms
|
||||||
|
- Cost optimization strategies
|
||||||
33
package-lock.json
generated
33
package-lock.json
generated
@@ -9,6 +9,7 @@
|
|||||||
"version": "0.1.1",
|
"version": "0.1.1",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@octokit/rest": "^22.0.0",
|
"@octokit/rest": "^22.0.0",
|
||||||
|
"@types/uuid": "^10.0.0",
|
||||||
"axios": "^1.6.2",
|
"axios": "^1.6.2",
|
||||||
"body-parser": "^2.2.0",
|
"body-parser": "^2.2.0",
|
||||||
"commander": "^14.0.0",
|
"commander": "^14.0.0",
|
||||||
@@ -17,7 +18,8 @@
|
|||||||
"express-rate-limit": "^7.5.0",
|
"express-rate-limit": "^7.5.0",
|
||||||
"pino": "^9.7.0",
|
"pino": "^9.7.0",
|
||||||
"pino-pretty": "^13.0.0",
|
"pino-pretty": "^13.0.0",
|
||||||
"typescript": "^5.8.3"
|
"typescript": "^5.8.3",
|
||||||
|
"uuid": "^11.1.0"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@babel/core": "^7.27.3",
|
"@babel/core": "^7.27.3",
|
||||||
@@ -3309,6 +3311,12 @@
|
|||||||
"@types/superagent": "^8.1.0"
|
"@types/superagent": "^8.1.0"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"node_modules/@types/uuid": {
|
||||||
|
"version": "10.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-10.0.0.tgz",
|
||||||
|
"integrity": "sha512-7gqG38EyHgyP1S+7+xomFtL+ZNHcKv6DwNaCZmJmo1vgMugyF3TCnXVg4t1uk89mLNwnLtnY3TpOpCOyp1/xHQ==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
"node_modules/@types/yargs": {
|
"node_modules/@types/yargs": {
|
||||||
"version": "17.0.33",
|
"version": "17.0.33",
|
||||||
"resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz",
|
"resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz",
|
||||||
@@ -8084,6 +8092,16 @@
|
|||||||
"node": ">=10.12.0"
|
"node": ">=10.12.0"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"node_modules/jest-junit/node_modules/uuid": {
|
||||||
|
"version": "8.3.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz",
|
||||||
|
"integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"bin": {
|
||||||
|
"uuid": "dist/bin/uuid"
|
||||||
|
}
|
||||||
|
},
|
||||||
"node_modules/jest-leak-detector": {
|
"node_modules/jest-leak-detector": {
|
||||||
"version": "29.7.0",
|
"version": "29.7.0",
|
||||||
"resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz",
|
"resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz",
|
||||||
@@ -11073,13 +11091,16 @@
|
|||||||
}
|
}
|
||||||
},
|
},
|
||||||
"node_modules/uuid": {
|
"node_modules/uuid": {
|
||||||
"version": "8.3.2",
|
"version": "11.1.0",
|
||||||
"resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz",
|
"resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.0.tgz",
|
||||||
"integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==",
|
"integrity": "sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==",
|
||||||
"dev": true,
|
"funding": [
|
||||||
|
"https://github.com/sponsors/broofa",
|
||||||
|
"https://github.com/sponsors/ctavan"
|
||||||
|
],
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"bin": {
|
"bin": {
|
||||||
"uuid": "dist/bin/uuid"
|
"uuid": "dist/esm/bin/uuid"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"node_modules/v8-compile-cache": {
|
"node_modules/v8-compile-cache": {
|
||||||
|
|||||||
@@ -43,7 +43,8 @@
|
|||||||
"express-rate-limit": "^7.5.0",
|
"express-rate-limit": "^7.5.0",
|
||||||
"pino": "^9.7.0",
|
"pino": "^9.7.0",
|
||||||
"pino-pretty": "^13.0.0",
|
"pino-pretty": "^13.0.0",
|
||||||
"typescript": "^5.8.3"
|
"typescript": "^5.8.3",
|
||||||
|
"uuid": "^11.1.0"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@babel/core": "^7.27.3",
|
"@babel/core": "^7.27.3",
|
||||||
@@ -54,6 +55,7 @@
|
|||||||
"@types/jest": "^29.5.14",
|
"@types/jest": "^29.5.14",
|
||||||
"@types/node": "^22.15.23",
|
"@types/node": "^22.15.23",
|
||||||
"@types/supertest": "^6.0.3",
|
"@types/supertest": "^6.0.3",
|
||||||
|
"@types/uuid": "^10.0.0",
|
||||||
"@typescript-eslint/eslint-plugin": "^8.33.0",
|
"@typescript-eslint/eslint-plugin": "^8.33.0",
|
||||||
"@typescript-eslint/parser": "^8.33.0",
|
"@typescript-eslint/parser": "^8.33.0",
|
||||||
"babel-jest": "^29.7.0",
|
"babel-jest": "^29.7.0",
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
/**
|
/**
|
||||||
* Allowed webhook providers
|
* Allowed webhook providers
|
||||||
*/
|
*/
|
||||||
export const ALLOWED_WEBHOOK_PROVIDERS = ['github'] as const;
|
export const ALLOWED_WEBHOOK_PROVIDERS = ['github', 'claude'] as const;
|
||||||
|
|
||||||
export type AllowedWebhookProvider = (typeof ALLOWED_WEBHOOK_PROVIDERS)[number];
|
export type AllowedWebhookProvider = (typeof ALLOWED_WEBHOOK_PROVIDERS)[number];
|
||||||
|
|
||||||
|
|||||||
113
src/providers/claude/ClaudeWebhookProvider.ts
Normal file
113
src/providers/claude/ClaudeWebhookProvider.ts
Normal file
@@ -0,0 +1,113 @@
|
|||||||
|
import { randomUUID } from 'crypto';
|
||||||
|
import type { WebhookRequest } from '../../types/express';
|
||||||
|
import type { WebhookProvider, BaseWebhookPayload } from '../../types/webhook';
|
||||||
|
import type { ClaudeOrchestrationPayload } from '../../types/claude-orchestration';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Claude webhook payload that conforms to BaseWebhookPayload
|
||||||
|
*/
|
||||||
|
export interface ClaudeWebhookPayload extends BaseWebhookPayload {
|
||||||
|
data: ClaudeOrchestrationPayload;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Claude webhook provider for orchestration
|
||||||
|
*/
|
||||||
|
export class ClaudeWebhookProvider implements WebhookProvider<ClaudeWebhookPayload> {
|
||||||
|
readonly name = 'claude';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Verify webhook signature - for Claude we'll use a simple bearer token for now
|
||||||
|
*/
|
||||||
|
verifySignature(req: WebhookRequest, secret: string): Promise<boolean> {
|
||||||
|
const authHeader = req.headers.authorization;
|
||||||
|
if (!authHeader?.startsWith('Bearer ')) {
|
||||||
|
return Promise.resolve(false);
|
||||||
|
}
|
||||||
|
|
||||||
|
const token = authHeader.substring(7);
|
||||||
|
return Promise.resolve(token === secret);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parse the Claude orchestration payload
|
||||||
|
*/
|
||||||
|
parsePayload(req: WebhookRequest): Promise<ClaudeWebhookPayload> {
|
||||||
|
const body = req.body as Partial<ClaudeOrchestrationPayload>;
|
||||||
|
|
||||||
|
// Validate required fields based on type
|
||||||
|
if (!body.type) {
|
||||||
|
return Promise.reject(new Error('Invalid payload: missing type field'));
|
||||||
|
}
|
||||||
|
|
||||||
|
// For orchestration-related types, project is required
|
||||||
|
if (['orchestrate', 'coordinate', 'session'].includes(body.type)) {
|
||||||
|
if (!body.project?.repository || !body.project.requirements) {
|
||||||
|
return Promise.reject(new Error('Invalid payload: missing required project fields'));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// For session.create, check for session field
|
||||||
|
if (body.type === 'session.create' && !body.session) {
|
||||||
|
return Promise.reject(new Error('Invalid payload: missing session field'));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Create the orchestration payload
|
||||||
|
const orchestrationPayload: ClaudeOrchestrationPayload = {
|
||||||
|
type: body.type,
|
||||||
|
project: body.project,
|
||||||
|
strategy: body.strategy,
|
||||||
|
sessionId: body.sessionId,
|
||||||
|
parentSessionId: body.parentSessionId,
|
||||||
|
dependencies: body.dependencies,
|
||||||
|
sessionType: body.sessionType,
|
||||||
|
autoStart: body.autoStart,
|
||||||
|
session: body.session
|
||||||
|
};
|
||||||
|
|
||||||
|
// Wrap in webhook payload format
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
id: `claude-${randomUUID()}`,
|
||||||
|
timestamp: new Date().toISOString(),
|
||||||
|
event: body.type,
|
||||||
|
source: 'claude',
|
||||||
|
data: orchestrationPayload
|
||||||
|
};
|
||||||
|
|
||||||
|
return Promise.resolve(payload);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the event type from the payload
|
||||||
|
*/
|
||||||
|
getEventType(payload: ClaudeWebhookPayload): string {
|
||||||
|
return payload.event;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get a human-readable description of the event
|
||||||
|
*/
|
||||||
|
getEventDescription(payload: ClaudeWebhookPayload): string {
|
||||||
|
const data = payload.data;
|
||||||
|
switch (data.type) {
|
||||||
|
case 'orchestrate':
|
||||||
|
return `Orchestrate Claude sessions for ${data.project?.repository ?? 'unknown'}`;
|
||||||
|
case 'session':
|
||||||
|
return `Manage Claude session ${data.sessionId ?? 'new'}`;
|
||||||
|
case 'coordinate':
|
||||||
|
return `Coordinate Claude sessions for ${data.project?.repository ?? 'unknown'}`;
|
||||||
|
case 'session.create':
|
||||||
|
return `Create new Claude session`;
|
||||||
|
case 'session.get':
|
||||||
|
return `Get Claude session ${data.sessionId ?? 'unknown'}`;
|
||||||
|
case 'session.list':
|
||||||
|
return `List Claude sessions`;
|
||||||
|
case 'session.start':
|
||||||
|
return `Start Claude session ${data.sessionId ?? 'unknown'}`;
|
||||||
|
case 'session.output':
|
||||||
|
return `Get output for Claude session ${data.sessionId ?? 'unknown'}`;
|
||||||
|
default:
|
||||||
|
return `Unknown Claude event type: ${data.type}`;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
105
src/providers/claude/handlers/OrchestrationHandler.ts
Normal file
105
src/providers/claude/handlers/OrchestrationHandler.ts
Normal file
@@ -0,0 +1,105 @@
|
|||||||
|
import { randomUUID } from 'crypto';
|
||||||
|
import { createLogger } from '../../../utils/logger';
|
||||||
|
import type {
|
||||||
|
WebhookEventHandler,
|
||||||
|
WebhookHandlerResponse,
|
||||||
|
WebhookContext
|
||||||
|
} from '../../../types/webhook';
|
||||||
|
import type {
|
||||||
|
ClaudeSession,
|
||||||
|
ClaudeOrchestrationResponse
|
||||||
|
} from '../../../types/claude-orchestration';
|
||||||
|
import type { ClaudeWebhookPayload } from '../ClaudeWebhookProvider';
|
||||||
|
import { SessionManager } from '../services/SessionManager';
|
||||||
|
|
||||||
|
const logger = createLogger('OrchestrationHandler');
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Handler for Claude orchestration requests
|
||||||
|
* Simplified to create a single session - orchestration happens via MCP tools
|
||||||
|
*/
|
||||||
|
export class OrchestrationHandler implements WebhookEventHandler<ClaudeWebhookPayload> {
|
||||||
|
event = 'orchestrate';
|
||||||
|
private sessionManager: SessionManager;
|
||||||
|
|
||||||
|
constructor() {
|
||||||
|
this.sessionManager = new SessionManager();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Check if this handler can handle the request
|
||||||
|
*/
|
||||||
|
canHandle(payload: ClaudeWebhookPayload): boolean {
|
||||||
|
return payload.data.type === 'orchestrate';
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Handle the orchestration request
|
||||||
|
* Creates a single session - actual orchestration is handled by MCP tools
|
||||||
|
*/
|
||||||
|
async handle(
|
||||||
|
payload: ClaudeWebhookPayload,
|
||||||
|
_context: WebhookContext
|
||||||
|
): Promise<WebhookHandlerResponse> {
|
||||||
|
try {
|
||||||
|
const data = payload.data;
|
||||||
|
|
||||||
|
if (!data.project) {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
error: 'Project information is required for orchestration'
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
logger.info('Creating orchestration session', {
|
||||||
|
repository: data.project.repository,
|
||||||
|
type: data.sessionType ?? 'coordination'
|
||||||
|
});
|
||||||
|
|
||||||
|
const orchestrationId = randomUUID();
|
||||||
|
|
||||||
|
// Create a single coordination session
|
||||||
|
const session: ClaudeSession = {
|
||||||
|
id: `${orchestrationId}-orchestrator`,
|
||||||
|
type: data.sessionType ?? 'coordination',
|
||||||
|
status: 'pending',
|
||||||
|
project: data.project,
|
||||||
|
dependencies: [],
|
||||||
|
output: undefined
|
||||||
|
};
|
||||||
|
|
||||||
|
// Initialize the session
|
||||||
|
const containerId = await this.sessionManager.createContainer(session);
|
||||||
|
const initializedSession = {
|
||||||
|
...session,
|
||||||
|
containerId,
|
||||||
|
status: 'initializing' as const
|
||||||
|
};
|
||||||
|
|
||||||
|
// Optionally start the session immediately
|
||||||
|
if (data.autoStart !== false) {
|
||||||
|
await this.sessionManager.startSession(initializedSession);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Prepare response
|
||||||
|
const response: ClaudeOrchestrationResponse = {
|
||||||
|
orchestrationId,
|
||||||
|
status: 'initiated',
|
||||||
|
sessions: [initializedSession],
|
||||||
|
summary: `Created orchestration session for ${data.project.repository}`
|
||||||
|
};
|
||||||
|
|
||||||
|
return {
|
||||||
|
success: true,
|
||||||
|
message: 'Orchestration session created',
|
||||||
|
data: response
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
logger.error('Failed to create orchestration session', { error });
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
error: error instanceof Error ? error.message : 'Failed to create orchestration session'
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
285
src/providers/claude/handlers/SessionHandler.ts
Normal file
285
src/providers/claude/handlers/SessionHandler.ts
Normal file
@@ -0,0 +1,285 @@
|
|||||||
|
import { createLogger } from '../../../utils/logger';
|
||||||
|
import type {
|
||||||
|
WebhookEventHandler,
|
||||||
|
WebhookHandlerResponse,
|
||||||
|
WebhookContext
|
||||||
|
} from '../../../types/webhook';
|
||||||
|
import type { ClaudeWebhookPayload } from '../ClaudeWebhookProvider';
|
||||||
|
import type { ClaudeSession } from '../../../types/claude-orchestration';
|
||||||
|
import { SessionManager } from '../services/SessionManager';
|
||||||
|
import { randomUUID } from 'crypto';
|
||||||
|
|
||||||
|
const logger = createLogger('SessionHandler');
|
||||||
|
|
||||||
|
interface SessionCreatePayload {
|
||||||
|
type: 'session.create';
|
||||||
|
session: Partial<ClaudeSession>;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface SessionGetPayload {
|
||||||
|
type: 'session.get';
|
||||||
|
sessionId: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface SessionListPayload {
|
||||||
|
type: 'session.list';
|
||||||
|
orchestrationId?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface SessionStartPayload {
|
||||||
|
type: 'session.start';
|
||||||
|
sessionId: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface SessionOutputPayload {
|
||||||
|
type: 'session.output';
|
||||||
|
sessionId: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
type SessionPayload =
|
||||||
|
| SessionCreatePayload
|
||||||
|
| SessionGetPayload
|
||||||
|
| SessionListPayload
|
||||||
|
| SessionStartPayload
|
||||||
|
| SessionOutputPayload;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Handler for individual Claude session management
|
||||||
|
* Provides CRUD operations for MCP integration
|
||||||
|
*/
|
||||||
|
export class SessionHandler implements WebhookEventHandler<ClaudeWebhookPayload> {
|
||||||
|
event = 'session';
|
||||||
|
private sessionManager: SessionManager;
|
||||||
|
|
||||||
|
constructor() {
|
||||||
|
this.sessionManager = new SessionManager();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Check if this handler can handle the request
|
||||||
|
*/
|
||||||
|
canHandle(payload: ClaudeWebhookPayload): boolean {
|
||||||
|
return payload.data.type.startsWith('session.');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Handle session management requests
|
||||||
|
*/
|
||||||
|
async handle(
|
||||||
|
payload: ClaudeWebhookPayload,
|
||||||
|
_context: WebhookContext
|
||||||
|
): Promise<WebhookHandlerResponse> {
|
||||||
|
try {
|
||||||
|
const data = payload.data as SessionPayload;
|
||||||
|
|
||||||
|
switch (data.type) {
|
||||||
|
case 'session.create':
|
||||||
|
return await this.handleCreateSession(data);
|
||||||
|
|
||||||
|
case 'session.get':
|
||||||
|
return await this.handleGetSession(data);
|
||||||
|
|
||||||
|
case 'session.list':
|
||||||
|
return await this.handleListSessions(data);
|
||||||
|
|
||||||
|
case 'session.start':
|
||||||
|
return await this.handleStartSession(data);
|
||||||
|
|
||||||
|
case 'session.output':
|
||||||
|
return await this.handleGetOutput(data);
|
||||||
|
|
||||||
|
default:
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
error: `Unknown session operation: ${(data as Record<string, unknown>).type}`
|
||||||
|
};
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
logger.error('Session operation failed', { error });
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
error: error instanceof Error ? error.message : 'Session operation failed'
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a new Claude session
|
||||||
|
*/
|
||||||
|
private async handleCreateSession(
|
||||||
|
payload: SessionCreatePayload
|
||||||
|
): Promise<WebhookHandlerResponse> {
|
||||||
|
const { session: partialSession } = payload;
|
||||||
|
|
||||||
|
// Validate required fields
|
||||||
|
if (!partialSession.project?.repository) {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
error: 'Repository is required for session creation'
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!partialSession.project.requirements) {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
error: 'Requirements are required for session creation'
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// Create full session object
|
||||||
|
const session: ClaudeSession = {
|
||||||
|
id: partialSession.id ?? randomUUID(),
|
||||||
|
type: partialSession.type ?? 'implementation',
|
||||||
|
status: 'pending',
|
||||||
|
project: partialSession.project,
|
||||||
|
dependencies: partialSession.dependencies ?? [],
|
||||||
|
output: undefined
|
||||||
|
};
|
||||||
|
|
||||||
|
// Create container but don't start it
|
||||||
|
const containerId = await this.sessionManager.createContainer(session);
|
||||||
|
|
||||||
|
const createdSession = {
|
||||||
|
...session,
|
||||||
|
containerId,
|
||||||
|
status: 'initializing' as const
|
||||||
|
};
|
||||||
|
|
||||||
|
logger.info('Session created', {
|
||||||
|
sessionId: createdSession.id,
|
||||||
|
type: createdSession.type,
|
||||||
|
repository: createdSession.project.repository
|
||||||
|
});
|
||||||
|
|
||||||
|
return {
|
||||||
|
success: true,
|
||||||
|
message: 'Session created successfully',
|
||||||
|
data: { session: createdSession }
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get session status
|
||||||
|
*/
|
||||||
|
private handleGetSession(payload: SessionGetPayload): Promise<WebhookHandlerResponse> {
|
||||||
|
const { sessionId } = payload;
|
||||||
|
const session = this.sessionManager.getSession(sessionId);
|
||||||
|
|
||||||
|
if (!session) {
|
||||||
|
return Promise.resolve({
|
||||||
|
success: false,
|
||||||
|
error: `Session not found: ${sessionId}`
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
return Promise.resolve({
|
||||||
|
success: true,
|
||||||
|
data: { session }
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* List sessions (optionally filtered by orchestration ID)
|
||||||
|
*/
|
||||||
|
private handleListSessions(payload: SessionListPayload): Promise<WebhookHandlerResponse> {
|
||||||
|
const { orchestrationId } = payload;
|
||||||
|
|
||||||
|
let sessions: ClaudeSession[];
|
||||||
|
if (orchestrationId) {
|
||||||
|
sessions = this.sessionManager.getOrchestrationSessions(orchestrationId);
|
||||||
|
} else {
|
||||||
|
sessions = this.sessionManager.getAllSessions();
|
||||||
|
}
|
||||||
|
|
||||||
|
return Promise.resolve({
|
||||||
|
success: true,
|
||||||
|
data: { sessions }
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Start a session
|
||||||
|
*/
|
||||||
|
private async handleStartSession(payload: SessionStartPayload): Promise<WebhookHandlerResponse> {
|
||||||
|
const { sessionId } = payload;
|
||||||
|
const session = this.sessionManager.getSession(sessionId);
|
||||||
|
|
||||||
|
if (!session) {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
error: `Session not found: ${sessionId}`
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
if (session.status !== 'initializing' && session.status !== 'pending') {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
error: `Session cannot be started in status: ${session.status}`
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check dependencies
|
||||||
|
const unmetDependencies = session.dependencies.filter(depId => {
|
||||||
|
const dep = this.sessionManager.getSession(depId);
|
||||||
|
return !dep || dep.status !== 'completed';
|
||||||
|
});
|
||||||
|
|
||||||
|
if (unmetDependencies.length > 0) {
|
||||||
|
// Queue the session to start when dependencies are met
|
||||||
|
await this.sessionManager.queueSession(session);
|
||||||
|
return {
|
||||||
|
success: true,
|
||||||
|
message: 'Session queued, waiting for dependencies',
|
||||||
|
data: {
|
||||||
|
session,
|
||||||
|
waitingFor: unmetDependencies
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// Start the session immediately
|
||||||
|
await this.sessionManager.startSession(session);
|
||||||
|
|
||||||
|
return {
|
||||||
|
success: true,
|
||||||
|
message: 'Session started',
|
||||||
|
data: { session }
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get session output
|
||||||
|
*/
|
||||||
|
private handleGetOutput(payload: SessionOutputPayload): Promise<WebhookHandlerResponse> {
|
||||||
|
const { sessionId } = payload;
|
||||||
|
const session = this.sessionManager.getSession(sessionId);
|
||||||
|
|
||||||
|
if (!session) {
|
||||||
|
return Promise.resolve({
|
||||||
|
success: false,
|
||||||
|
error: `Session not found: ${sessionId}`
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!session.output) {
|
||||||
|
return Promise.resolve({
|
||||||
|
success: true,
|
||||||
|
data: {
|
||||||
|
sessionId,
|
||||||
|
status: session.status,
|
||||||
|
output: null,
|
||||||
|
message: 'Session has no output yet'
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
return Promise.resolve({
|
||||||
|
success: true,
|
||||||
|
data: {
|
||||||
|
sessionId,
|
||||||
|
status: session.status,
|
||||||
|
output: session.output
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
23
src/providers/claude/index.ts
Normal file
23
src/providers/claude/index.ts
Normal file
@@ -0,0 +1,23 @@
|
|||||||
|
import { webhookRegistry } from '../../core/webhook/WebhookRegistry';
|
||||||
|
import { ClaudeWebhookProvider } from './ClaudeWebhookProvider';
|
||||||
|
import { OrchestrationHandler } from './handlers/OrchestrationHandler';
|
||||||
|
import { SessionHandler } from './handlers/SessionHandler';
|
||||||
|
import { createLogger } from '../../utils/logger';
|
||||||
|
|
||||||
|
const logger = createLogger('ClaudeProvider');
|
||||||
|
|
||||||
|
// Register the Claude provider
|
||||||
|
const provider = new ClaudeWebhookProvider();
|
||||||
|
webhookRegistry.registerProvider(provider);
|
||||||
|
|
||||||
|
// Register handlers
|
||||||
|
webhookRegistry.registerHandler('claude', new OrchestrationHandler());
|
||||||
|
webhookRegistry.registerHandler('claude', new SessionHandler());
|
||||||
|
|
||||||
|
logger.info('Claude webhook provider initialized');
|
||||||
|
|
||||||
|
export { ClaudeWebhookProvider };
|
||||||
|
export * from './handlers/OrchestrationHandler';
|
||||||
|
export * from './handlers/SessionHandler';
|
||||||
|
export * from './services/SessionManager';
|
||||||
|
export * from './services/TaskDecomposer';
|
||||||
291
src/providers/claude/services/SessionManager.ts
Normal file
291
src/providers/claude/services/SessionManager.ts
Normal file
@@ -0,0 +1,291 @@
|
|||||||
|
import { spawn, execSync } from 'child_process';
|
||||||
|
import { createLogger } from '../../../utils/logger';
|
||||||
|
import type {
|
||||||
|
ClaudeSession,
|
||||||
|
SessionOutput,
|
||||||
|
SessionArtifact
|
||||||
|
} from '../../../types/claude-orchestration';
|
||||||
|
|
||||||
|
const logger = createLogger('SessionManager');
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Manages Claude container sessions for orchestration
|
||||||
|
*/
|
||||||
|
export class SessionManager {
|
||||||
|
private sessions: Map<string, ClaudeSession> = new Map();
|
||||||
|
private sessionQueues: Map<string, string[]> = new Map(); // sessionId -> waiting sessions
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a container for a session
|
||||||
|
*/
|
||||||
|
createContainer(session: ClaudeSession): Promise<string> {
|
||||||
|
try {
|
||||||
|
// Generate container name
|
||||||
|
const containerName = `claude-${session.type}-${session.id.substring(0, 8)}`;
|
||||||
|
|
||||||
|
// Get Docker image from environment
|
||||||
|
const dockerImage = process.env.CLAUDE_CONTAINER_IMAGE ?? 'claudecode:latest';
|
||||||
|
|
||||||
|
// Set up volume mounts for persistent storage
|
||||||
|
const volumeName = `claude-session-${session.id.substring(0, 8)}`;
|
||||||
|
|
||||||
|
// Create container without starting it
|
||||||
|
const createCmd = [
|
||||||
|
'docker',
|
||||||
|
'create',
|
||||||
|
'--name',
|
||||||
|
containerName,
|
||||||
|
'--rm',
|
||||||
|
'-v',
|
||||||
|
`${volumeName}:/home/user/project`,
|
||||||
|
'-v',
|
||||||
|
`${volumeName}-claude:/home/user/.claude`,
|
||||||
|
'-e',
|
||||||
|
`SESSION_ID=${session.id}`,
|
||||||
|
'-e',
|
||||||
|
`SESSION_TYPE=${session.type}`,
|
||||||
|
'-e',
|
||||||
|
`GITHUB_TOKEN=${process.env.GITHUB_TOKEN ?? ''}`,
|
||||||
|
'-e',
|
||||||
|
`ANTHROPIC_API_KEY=${process.env.ANTHROPIC_API_KEY ?? ''}`,
|
||||||
|
'-e',
|
||||||
|
`REPOSITORY=${session.project.repository}`,
|
||||||
|
'-e',
|
||||||
|
`OPERATION_TYPE=session`,
|
||||||
|
'--workdir',
|
||||||
|
'/home/user/project',
|
||||||
|
dockerImage,
|
||||||
|
'/scripts/runtime/claudecode-entrypoint.sh'
|
||||||
|
];
|
||||||
|
|
||||||
|
execSync(createCmd.join(' '), { stdio: 'pipe' });
|
||||||
|
|
||||||
|
logger.info('Container created', { sessionId: session.id, containerName });
|
||||||
|
|
||||||
|
// Store session
|
||||||
|
this.sessions.set(session.id, session);
|
||||||
|
|
||||||
|
return Promise.resolve(containerName);
|
||||||
|
} catch (error) {
|
||||||
|
logger.error('Failed to create container', { sessionId: session.id, error });
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Start a session
|
||||||
|
*/
|
||||||
|
startSession(session: ClaudeSession): Promise<void> {
|
||||||
|
try {
|
||||||
|
if (!session.containerId) {
|
||||||
|
throw new Error('Session has no container ID');
|
||||||
|
}
|
||||||
|
|
||||||
|
logger.info('Starting session', { sessionId: session.id, type: session.type });
|
||||||
|
|
||||||
|
// Update session status
|
||||||
|
session.status = 'running';
|
||||||
|
session.startedAt = new Date();
|
||||||
|
this.sessions.set(session.id, session);
|
||||||
|
|
||||||
|
// Prepare the command based on session type
|
||||||
|
const command = this.buildSessionCommand(session);
|
||||||
|
|
||||||
|
// Start the container and execute Claude
|
||||||
|
const execCmd = [
|
||||||
|
'docker',
|
||||||
|
'exec',
|
||||||
|
'-i',
|
||||||
|
session.containerId,
|
||||||
|
'claude',
|
||||||
|
'chat',
|
||||||
|
'--no-prompt',
|
||||||
|
'-m',
|
||||||
|
command
|
||||||
|
];
|
||||||
|
|
||||||
|
// First start the container
|
||||||
|
execSync(`docker start ${session.containerId}`, { stdio: 'pipe' });
|
||||||
|
|
||||||
|
// Then execute Claude command
|
||||||
|
const dockerProcess = spawn(execCmd[0], execCmd.slice(1), {
|
||||||
|
env: process.env
|
||||||
|
});
|
||||||
|
|
||||||
|
// Collect output
|
||||||
|
const logs: string[] = [];
|
||||||
|
|
||||||
|
dockerProcess.stdout.on('data', data => {
|
||||||
|
const line = data.toString();
|
||||||
|
logs.push(line);
|
||||||
|
logger.debug('Session output', { sessionId: session.id, line });
|
||||||
|
});
|
||||||
|
|
||||||
|
dockerProcess.stderr.on('data', data => {
|
||||||
|
const line = data.toString();
|
||||||
|
logs.push(`ERROR: ${line}`);
|
||||||
|
logger.error('Session error', { sessionId: session.id, line });
|
||||||
|
});
|
||||||
|
|
||||||
|
dockerProcess.on('close', code => {
|
||||||
|
session.status = code === 0 ? 'completed' : 'failed';
|
||||||
|
session.completedAt = new Date();
|
||||||
|
session.output = this.parseSessionOutput(logs);
|
||||||
|
|
||||||
|
if (code !== 0) {
|
||||||
|
session.error = `Process exited with code ${code}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
this.sessions.set(session.id, session);
|
||||||
|
logger.info('Session completed', { sessionId: session.id, status: session.status });
|
||||||
|
|
||||||
|
// Notify waiting sessions
|
||||||
|
this.notifyWaitingSessions(session.id);
|
||||||
|
});
|
||||||
|
|
||||||
|
return Promise.resolve();
|
||||||
|
} catch (error) {
|
||||||
|
logger.error('Failed to start session', { sessionId: session.id, error });
|
||||||
|
session.status = 'failed';
|
||||||
|
session.error = error instanceof Error ? error.message : 'Unknown error';
|
||||||
|
this.sessions.set(session.id, session);
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Queue a session to start when dependencies are met
|
||||||
|
*/
|
||||||
|
async queueSession(session: ClaudeSession): Promise<void> {
|
||||||
|
// Check if all dependencies are completed
|
||||||
|
const allDependenciesMet = session.dependencies.every(depId => {
|
||||||
|
const dep = this.sessions.get(depId);
|
||||||
|
return dep && dep.status === 'completed';
|
||||||
|
});
|
||||||
|
|
||||||
|
if (allDependenciesMet) {
|
||||||
|
await this.startSession(session);
|
||||||
|
} else {
|
||||||
|
// Add to waiting queues
|
||||||
|
for (const depId of session.dependencies) {
|
||||||
|
const queue = this.sessionQueues.get(depId) ?? [];
|
||||||
|
queue.push(session.id);
|
||||||
|
this.sessionQueues.set(depId, queue);
|
||||||
|
}
|
||||||
|
logger.info('Session queued', { sessionId: session.id, waitingFor: session.dependencies });
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get session status
|
||||||
|
*/
|
||||||
|
getSession(sessionId: string): ClaudeSession | undefined {
|
||||||
|
return this.sessions.get(sessionId);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get all sessions for an orchestration
|
||||||
|
*/
|
||||||
|
getOrchestrationSessions(orchestrationId: string): ClaudeSession[] {
|
||||||
|
return Array.from(this.sessions.values()).filter(session =>
|
||||||
|
session.id.startsWith(orchestrationId)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get all sessions
|
||||||
|
*/
|
||||||
|
getAllSessions(): ClaudeSession[] {
|
||||||
|
return Array.from(this.sessions.values());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Build command for session based on type
|
||||||
|
*/
|
||||||
|
private buildSessionCommand(session: ClaudeSession): string {
|
||||||
|
const { repository, requirements, context } = session.project;
|
||||||
|
|
||||||
|
switch (session.type) {
|
||||||
|
case 'analysis':
|
||||||
|
return `Analyze the project ${repository} and create a detailed implementation plan for: ${requirements}`;
|
||||||
|
|
||||||
|
case 'implementation':
|
||||||
|
return `Implement the following in ${repository}: ${requirements}. ${context ?? ''}`;
|
||||||
|
|
||||||
|
case 'testing':
|
||||||
|
return `Write comprehensive tests for the implementation in ${repository}`;
|
||||||
|
|
||||||
|
case 'review':
|
||||||
|
return `Review the code changes in ${repository} and provide feedback`;
|
||||||
|
|
||||||
|
case 'coordination':
|
||||||
|
return `Coordinate the implementation of ${requirements} in ${repository}`;
|
||||||
|
|
||||||
|
default:
|
||||||
|
return requirements;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parse session output into structured format
|
||||||
|
*/
|
||||||
|
private parseSessionOutput(logs: string[]): SessionOutput {
|
||||||
|
const artifacts: SessionArtifact[] = [];
|
||||||
|
const summary: string[] = [];
|
||||||
|
const nextSteps: string[] = [];
|
||||||
|
|
||||||
|
// Simple parsing - in reality, we'd have more sophisticated parsing
|
||||||
|
for (const line of logs) {
|
||||||
|
if (line.includes('Created file:')) {
|
||||||
|
artifacts.push({
|
||||||
|
type: 'file',
|
||||||
|
path: line.split('Created file:')[1].trim()
|
||||||
|
});
|
||||||
|
} else if (line.includes('Committed:')) {
|
||||||
|
artifacts.push({
|
||||||
|
type: 'commit',
|
||||||
|
sha: line.split('Committed:')[1].trim()
|
||||||
|
});
|
||||||
|
} else if (line.includes('Summary:')) {
|
||||||
|
summary.push(line.split('Summary:')[1].trim());
|
||||||
|
} else if (line.includes('Next step:')) {
|
||||||
|
nextSteps.push(line.split('Next step:')[1].trim());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
logs,
|
||||||
|
artifacts,
|
||||||
|
summary: summary.length > 0 ? summary.join('\n') : 'Session completed',
|
||||||
|
nextSteps
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Notify waiting sessions when a dependency completes
|
||||||
|
*/
|
||||||
|
private notifyWaitingSessions(completedSessionId: string): void {
|
||||||
|
const waitingSessionIds = this.sessionQueues.get(completedSessionId) ?? [];
|
||||||
|
|
||||||
|
for (const waitingId of waitingSessionIds) {
|
||||||
|
const waitingSession = this.sessions.get(waitingId);
|
||||||
|
if (waitingSession) {
|
||||||
|
// Check if all dependencies are now met
|
||||||
|
const allDependenciesMet = waitingSession.dependencies.every(depId => {
|
||||||
|
const dep = this.sessions.get(depId);
|
||||||
|
return dep && dep.status === 'completed';
|
||||||
|
});
|
||||||
|
|
||||||
|
if (allDependenciesMet) {
|
||||||
|
logger.info('Starting waiting session', { sessionId: waitingId });
|
||||||
|
this.startSession(waitingSession).catch(error => {
|
||||||
|
logger.error('Failed to start waiting session', { sessionId: waitingId, error });
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Clean up the queue
|
||||||
|
this.sessionQueues.delete(completedSessionId);
|
||||||
|
}
|
||||||
|
}
|
||||||
189
src/providers/claude/services/TaskDecomposer.ts
Normal file
189
src/providers/claude/services/TaskDecomposer.ts
Normal file
@@ -0,0 +1,189 @@
|
|||||||
|
import { createLogger } from '../../../utils/logger';
|
||||||
|
import type { ProjectInfo } from '../../../types/claude-orchestration';
|
||||||
|
|
||||||
|
const logger = createLogger('TaskDecomposer');
|
||||||
|
|
||||||
|
export interface TaskComponent {
|
||||||
|
name: string;
|
||||||
|
requirements: string;
|
||||||
|
context?: string;
|
||||||
|
dependencies?: string[];
|
||||||
|
priority: 'high' | 'medium' | 'low';
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface TaskDecomposition {
|
||||||
|
components: TaskComponent[];
|
||||||
|
strategy: 'sequential' | 'parallel' | 'wait_for_core';
|
||||||
|
estimatedSessions: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Named constant for extra sessions
|
||||||
|
const EXTRA_SESSIONS_COUNT = 3; // For analysis, testing, and review
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Decomposes complex tasks into manageable components
|
||||||
|
* This is a simplified version - Claude will handle the actual intelligent decomposition
|
||||||
|
*/
|
||||||
|
export class TaskDecomposer {
|
||||||
|
/**
|
||||||
|
* Decompose a project into individual components
|
||||||
|
*/
|
||||||
|
decompose(project: ProjectInfo): TaskDecomposition {
|
||||||
|
logger.info('Decomposing project', { repository: project.repository });
|
||||||
|
|
||||||
|
// Analyze requirements to identify components
|
||||||
|
const components = this.analyzeRequirements(project.requirements);
|
||||||
|
|
||||||
|
// Determine strategy based on components
|
||||||
|
const strategy = this.determineStrategy(components);
|
||||||
|
|
||||||
|
const decomposition = {
|
||||||
|
components,
|
||||||
|
strategy,
|
||||||
|
estimatedSessions: components.length + EXTRA_SESSIONS_COUNT
|
||||||
|
};
|
||||||
|
|
||||||
|
return decomposition;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Analyze requirements and extract components
|
||||||
|
* This is a simplified version for testing - Claude will do the real analysis
|
||||||
|
*/
|
||||||
|
private analyzeRequirements(requirements: string): TaskComponent[] {
|
||||||
|
const components: TaskComponent[] = [];
|
||||||
|
|
||||||
|
// Keywords that indicate different components
|
||||||
|
const componentKeywords = {
|
||||||
|
api: ['api', 'endpoint', 'rest', 'graphql', 'service'],
|
||||||
|
frontend: ['ui', 'frontend', 'react', 'vue', 'angular', 'interface'],
|
||||||
|
backend: ['backend', 'server', 'database', 'model', 'schema'],
|
||||||
|
auth: ['auth', 'authentication', 'authorization', 'security', 'jwt', 'oauth'],
|
||||||
|
testing: ['test', 'testing', 'unit test', 'integration test'],
|
||||||
|
deployment: ['deploy', 'deployment', 'docker', 'kubernetes', 'ci/cd']
|
||||||
|
};
|
||||||
|
|
||||||
|
const lowerRequirements = requirements.toLowerCase();
|
||||||
|
|
||||||
|
// First pass: identify which components exist
|
||||||
|
const existingComponents = new Set<string>();
|
||||||
|
for (const [componentType, keywords] of Object.entries(componentKeywords)) {
|
||||||
|
const hasComponent = keywords.some(keyword => lowerRequirements.includes(keyword));
|
||||||
|
if (hasComponent) {
|
||||||
|
existingComponents.add(componentType);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Second pass: create components with proper dependencies
|
||||||
|
for (const [componentType, keywords] of Object.entries(componentKeywords)) {
|
||||||
|
const hasComponent = keywords.some(keyword => lowerRequirements.includes(keyword));
|
||||||
|
|
||||||
|
if (hasComponent) {
|
||||||
|
let priority: 'high' | 'medium' | 'low' = 'medium';
|
||||||
|
let dependencies: string[] = [];
|
||||||
|
|
||||||
|
// Set priorities and dependencies based on component type
|
||||||
|
switch (componentType) {
|
||||||
|
case 'auth':
|
||||||
|
priority = 'high';
|
||||||
|
break;
|
||||||
|
case 'backend':
|
||||||
|
priority = 'high';
|
||||||
|
break;
|
||||||
|
case 'api':
|
||||||
|
priority = 'high';
|
||||||
|
// Only add backend dependency if backend component exists
|
||||||
|
if (existingComponents.has('backend')) {
|
||||||
|
dependencies = ['backend'];
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
case 'frontend':
|
||||||
|
priority = 'medium';
|
||||||
|
// Only add api dependency if api component exists
|
||||||
|
if (existingComponents.has('api')) {
|
||||||
|
dependencies = ['api'];
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
case 'testing':
|
||||||
|
priority = 'low';
|
||||||
|
// Add dependencies for all existing components
|
||||||
|
dependencies = ['backend', 'api', 'frontend'].filter(dep =>
|
||||||
|
existingComponents.has(dep)
|
||||||
|
);
|
||||||
|
break;
|
||||||
|
case 'deployment':
|
||||||
|
priority = 'low';
|
||||||
|
// Add dependencies for all existing components
|
||||||
|
dependencies = ['backend', 'api', 'frontend', 'testing'].filter(dep =>
|
||||||
|
existingComponents.has(dep)
|
||||||
|
);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
components.push({
|
||||||
|
name: componentType,
|
||||||
|
requirements: this.extractComponentRequirements(requirements, componentType, keywords),
|
||||||
|
priority,
|
||||||
|
dependencies
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// If no specific components found, create a single implementation component
|
||||||
|
if (components.length === 0) {
|
||||||
|
components.push({
|
||||||
|
name: 'implementation',
|
||||||
|
requirements: requirements,
|
||||||
|
priority: 'high',
|
||||||
|
dependencies: []
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
return components;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Extract specific requirements for a component
|
||||||
|
*/
|
||||||
|
private extractComponentRequirements(
|
||||||
|
requirements: string,
|
||||||
|
componentType: string,
|
||||||
|
keywords: string[]
|
||||||
|
): string {
|
||||||
|
// Find sentences or phrases that contain the keywords
|
||||||
|
const sentences = requirements.split(/[.!?]+/);
|
||||||
|
const relevantSentences = sentences.filter(sentence => {
|
||||||
|
const lowerSentence = sentence.toLowerCase();
|
||||||
|
return keywords.some(keyword => lowerSentence.includes(keyword));
|
||||||
|
});
|
||||||
|
|
||||||
|
if (relevantSentences.length > 0) {
|
||||||
|
return relevantSentences.join('. ').trim();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Fallback to generic description
|
||||||
|
return `Implement ${componentType} functionality as described in the overall requirements`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determine the best strategy based on components
|
||||||
|
*/
|
||||||
|
private determineStrategy(
|
||||||
|
components: TaskComponent[]
|
||||||
|
): 'sequential' | 'parallel' | 'wait_for_core' {
|
||||||
|
// If we have dependencies, use wait_for_core strategy
|
||||||
|
const hasDependencies = components.some(c => c.dependencies && c.dependencies.length > 0);
|
||||||
|
|
||||||
|
if (hasDependencies) {
|
||||||
|
return 'wait_for_core';
|
||||||
|
}
|
||||||
|
|
||||||
|
// If we have many independent components, use parallel
|
||||||
|
if (components.length > 3) {
|
||||||
|
return 'parallel';
|
||||||
|
}
|
||||||
|
|
||||||
|
// Default to sequential for small projects
|
||||||
|
return 'sequential';
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -43,6 +43,7 @@ export class GitHubWebhookProvider implements WebhookProvider<GitHubWebhookEvent
|
|||||||
* Verify GitHub webhook signature
|
* Verify GitHub webhook signature
|
||||||
*/
|
*/
|
||||||
verifySignature(req: WebhookRequest, secret: string): Promise<boolean> {
|
verifySignature(req: WebhookRequest, secret: string): Promise<boolean> {
|
||||||
|
// eslint-disable-next-line no-sync
|
||||||
return Promise.resolve(this.verifySignatureSync(req, secret));
|
return Promise.resolve(this.verifySignatureSync(req, secret));
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -79,6 +80,7 @@ export class GitHubWebhookProvider implements WebhookProvider<GitHubWebhookEvent
|
|||||||
* Parse GitHub webhook payload
|
* Parse GitHub webhook payload
|
||||||
*/
|
*/
|
||||||
parsePayload(req: WebhookRequest): Promise<GitHubWebhookEvent> {
|
parsePayload(req: WebhookRequest): Promise<GitHubWebhookEvent> {
|
||||||
|
// eslint-disable-next-line no-sync
|
||||||
return Promise.resolve(this.parsePayloadSync(req));
|
return Promise.resolve(this.parsePayloadSync(req));
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -173,7 +175,9 @@ export class GitHubWebhookProvider implements WebhookProvider<GitHubWebhookEvent
|
|||||||
body: issue.body ?? '',
|
body: issue.body ?? '',
|
||||||
state: issue.state,
|
state: issue.state,
|
||||||
author: GitHubWebhookProvider.transformUser(issue.user),
|
author: GitHubWebhookProvider.transformUser(issue.user),
|
||||||
labels: issue.labels?.map(label => (typeof label === 'string' ? label : label.name)) ?? [],
|
labels: issue.labels
|
||||||
|
? issue.labels.map(label => (typeof label === 'string' ? label : label.name))
|
||||||
|
: [],
|
||||||
createdAt: new Date(issue.created_at),
|
createdAt: new Date(issue.created_at),
|
||||||
updatedAt: new Date(issue.updated_at)
|
updatedAt: new Date(issue.updated_at)
|
||||||
};
|
};
|
||||||
@@ -190,7 +194,9 @@ export class GitHubWebhookProvider implements WebhookProvider<GitHubWebhookEvent
|
|||||||
body: pr.body ?? '',
|
body: pr.body ?? '',
|
||||||
state: pr.state as 'open' | 'closed',
|
state: pr.state as 'open' | 'closed',
|
||||||
author: GitHubWebhookProvider.transformUser(pr.user),
|
author: GitHubWebhookProvider.transformUser(pr.user),
|
||||||
labels: pr.labels?.map(label => (typeof label === 'string' ? label : label.name)) ?? [],
|
labels: pr.labels
|
||||||
|
? pr.labels.map(label => (typeof label === 'string' ? label : label.name))
|
||||||
|
: [],
|
||||||
createdAt: new Date(pr.created_at),
|
createdAt: new Date(pr.created_at),
|
||||||
updatedAt: new Date(pr.updated_at),
|
updatedAt: new Date(pr.updated_at),
|
||||||
sourceBranch: pr.head.ref,
|
sourceBranch: pr.head.ref,
|
||||||
|
|||||||
@@ -15,6 +15,10 @@ if (process.env.NODE_ENV !== 'test') {
|
|||||||
import('../providers/github').catch(err => {
|
import('../providers/github').catch(err => {
|
||||||
logger.error({ err }, 'Failed to initialize GitHub provider');
|
logger.error({ err }, 'Failed to initialize GitHub provider');
|
||||||
});
|
});
|
||||||
|
|
||||||
|
import('../providers/claude').catch(err => {
|
||||||
|
logger.error({ err }, 'Failed to initialize Claude provider');
|
||||||
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
150
src/types/claude-orchestration.ts
Normal file
150
src/types/claude-orchestration.ts
Normal file
@@ -0,0 +1,150 @@
|
|||||||
|
/**
|
||||||
|
* Types for Claude orchestration system
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Session types for different Claude operations
|
||||||
|
*/
|
||||||
|
export type SessionType = 'analysis' | 'implementation' | 'testing' | 'review' | 'coordination';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Session status
|
||||||
|
*/
|
||||||
|
export type SessionStatus =
|
||||||
|
| 'pending'
|
||||||
|
| 'initializing'
|
||||||
|
| 'running'
|
||||||
|
| 'completed'
|
||||||
|
| 'failed'
|
||||||
|
| 'cancelled';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Orchestration strategy
|
||||||
|
*/
|
||||||
|
export interface OrchestrationStrategy {
|
||||||
|
parallelSessions?: number;
|
||||||
|
phases?: SessionType[];
|
||||||
|
dependencyMode?: 'sequential' | 'wait_for_core' | 'parallel';
|
||||||
|
timeout?: number; // in milliseconds
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Project information for orchestration
|
||||||
|
*/
|
||||||
|
export interface ProjectInfo {
|
||||||
|
repository: string;
|
||||||
|
branch?: string;
|
||||||
|
requirements: string;
|
||||||
|
context?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base payload for all Claude operations
|
||||||
|
*/
|
||||||
|
export interface BaseClaudePayload {
|
||||||
|
type: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Claude orchestration request payload
|
||||||
|
*/
|
||||||
|
export interface ClaudeOrchestrationPayload extends BaseClaudePayload {
|
||||||
|
type:
|
||||||
|
| 'orchestrate'
|
||||||
|
| 'session'
|
||||||
|
| 'coordinate'
|
||||||
|
| 'session.create'
|
||||||
|
| 'session.get'
|
||||||
|
| 'session.list'
|
||||||
|
| 'session.start'
|
||||||
|
| 'session.output';
|
||||||
|
project?: ProjectInfo;
|
||||||
|
strategy?: OrchestrationStrategy;
|
||||||
|
sessionId?: string;
|
||||||
|
parentSessionId?: string;
|
||||||
|
dependencies?: string[]; // Session IDs to wait for
|
||||||
|
sessionType?: SessionType; // Type of session to create
|
||||||
|
autoStart?: boolean; // Whether to start session immediately
|
||||||
|
session?: Partial<ClaudeSession>; // For session.create
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Claude orchestration request (webhook format)
|
||||||
|
*/
|
||||||
|
export interface ClaudeOrchestrationRequest {
|
||||||
|
id: string;
|
||||||
|
timestamp: string;
|
||||||
|
type: 'orchestrate' | 'session' | 'coordinate';
|
||||||
|
project: ProjectInfo;
|
||||||
|
strategy?: OrchestrationStrategy;
|
||||||
|
sessionId?: string;
|
||||||
|
parentSessionId?: string;
|
||||||
|
dependencies?: string[]; // Session IDs to wait for
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Individual Claude session
|
||||||
|
*/
|
||||||
|
export interface ClaudeSession {
|
||||||
|
id: string;
|
||||||
|
type: SessionType;
|
||||||
|
status: SessionStatus;
|
||||||
|
containerId?: string;
|
||||||
|
project: ProjectInfo;
|
||||||
|
dependencies: string[];
|
||||||
|
startedAt?: Date;
|
||||||
|
completedAt?: Date;
|
||||||
|
output?: SessionOutput;
|
||||||
|
error?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Session output
|
||||||
|
*/
|
||||||
|
export interface SessionOutput {
|
||||||
|
logs: string[];
|
||||||
|
artifacts: SessionArtifact[];
|
||||||
|
summary: string;
|
||||||
|
nextSteps?: string[];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Session artifact (file, commit, etc.)
|
||||||
|
*/
|
||||||
|
export interface SessionArtifact {
|
||||||
|
type: 'file' | 'commit' | 'pr' | 'issue' | 'comment';
|
||||||
|
path?: string;
|
||||||
|
content?: string;
|
||||||
|
sha?: string;
|
||||||
|
url?: string;
|
||||||
|
metadata?: Record<string, unknown>;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Orchestration response
|
||||||
|
*/
|
||||||
|
export interface ClaudeOrchestrationResponse {
|
||||||
|
orchestrationId: string;
|
||||||
|
status: 'initiated' | 'running' | 'completed' | 'failed';
|
||||||
|
sessions: ClaudeSession[];
|
||||||
|
summary?: string;
|
||||||
|
errors?: string[];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Session management request
|
||||||
|
*/
|
||||||
|
export interface SessionManagementRequest {
|
||||||
|
action: 'start' | 'stop' | 'status' | 'logs';
|
||||||
|
sessionId: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Inter-session communication
|
||||||
|
*/
|
||||||
|
export interface SessionCoordinationMessage {
|
||||||
|
fromSessionId: string;
|
||||||
|
toSessionId: string;
|
||||||
|
type: 'dependency_completed' | 'artifact_ready' | 'request_review' | 'custom';
|
||||||
|
payload?: unknown;
|
||||||
|
}
|
||||||
394
test/integration/claude/claude-session.test.ts
Normal file
394
test/integration/claude/claude-session.test.ts
Normal file
@@ -0,0 +1,394 @@
|
|||||||
|
import request from 'supertest';
|
||||||
|
import express from 'express';
|
||||||
|
|
||||||
|
// Mock child_process to prevent Docker commands
|
||||||
|
jest.mock('child_process', () => ({
|
||||||
|
execSync: jest.fn(() => ''),
|
||||||
|
spawn: jest.fn(() => ({
|
||||||
|
stdout: { on: jest.fn() },
|
||||||
|
stderr: { on: jest.fn() },
|
||||||
|
on: jest.fn((event, callback) => {
|
||||||
|
if (event === 'close') {
|
||||||
|
setTimeout(() => callback(0), 100);
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}))
|
||||||
|
}));
|
||||||
|
|
||||||
|
// Mock SessionManager to avoid Docker calls in CI
|
||||||
|
jest.mock('../../../src/providers/claude/services/SessionManager', () => {
|
||||||
|
return {
|
||||||
|
SessionManager: jest.fn().mockImplementation(() => ({
|
||||||
|
createContainer: jest.fn().mockResolvedValue('mock-container-id'),
|
||||||
|
startSession: jest.fn().mockResolvedValue(undefined),
|
||||||
|
getSession: jest.fn().mockImplementation(id => ({
|
||||||
|
id,
|
||||||
|
status: 'running',
|
||||||
|
type: 'implementation',
|
||||||
|
project: { repository: 'test/repo', requirements: 'test' },
|
||||||
|
dependencies: []
|
||||||
|
})),
|
||||||
|
listSessions: jest.fn().mockResolvedValue([]),
|
||||||
|
getSessionOutput: jest.fn().mockResolvedValue({ output: 'test output' }),
|
||||||
|
canStartSession: jest.fn().mockResolvedValue(true),
|
||||||
|
updateSessionStatus: jest.fn().mockResolvedValue(undefined)
|
||||||
|
}))
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
// Now we can import the routes
|
||||||
|
import webhookRoutes from '../../../src/routes/webhooks';
|
||||||
|
|
||||||
|
// Mock environment variables
|
||||||
|
process.env.CLAUDE_WEBHOOK_SECRET = 'test-secret';
|
||||||
|
process.env.SKIP_WEBHOOK_VERIFICATION = '1';
|
||||||
|
|
||||||
|
describe('Claude Session Integration Tests', () => {
|
||||||
|
let app: express.Application;
|
||||||
|
|
||||||
|
beforeAll(() => {
|
||||||
|
// Import provider to register handlers
|
||||||
|
require('../../../src/providers/claude');
|
||||||
|
});
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
app = express();
|
||||||
|
app.use(express.json());
|
||||||
|
app.use('/api/webhooks', webhookRoutes);
|
||||||
|
});
|
||||||
|
|
||||||
|
afterEach(() => {
|
||||||
|
jest.clearAllMocks();
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('POST /api/webhooks/claude - Session Management', () => {
|
||||||
|
it('should create a new session', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.success).toBe(true);
|
||||||
|
expect(response.body.data.session).toMatchObject({
|
||||||
|
type: 'implementation',
|
||||||
|
status: 'initializing',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
});
|
||||||
|
expect(response.body.data.session.id).toBeDefined();
|
||||||
|
expect(response.body.data.session.containerId).toBeDefined();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should create session with custom type', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
type: 'analysis',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.success).toBe(true);
|
||||||
|
expect(response.body.data.session.type).toBe('analysis');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject session creation without repository', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.success).toBe(false);
|
||||||
|
expect(response.body.error).toBe('Repository is required for session creation');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject session creation without requirements', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.success).toBe(false);
|
||||||
|
expect(response.body.error).toBe('Requirements are required for session creation');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle session.get request', async () => {
|
||||||
|
// First create a session
|
||||||
|
const createPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const createResponse = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(createPayload);
|
||||||
|
|
||||||
|
const sessionId = createResponse.body.data.session.id;
|
||||||
|
|
||||||
|
// Then get the session
|
||||||
|
const getPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.get',
|
||||||
|
sessionId
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const getResponse = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(getPayload);
|
||||||
|
|
||||||
|
expect(getResponse.status).toBe(200);
|
||||||
|
expect(getResponse.body.success).toBe(true);
|
||||||
|
expect(getResponse.body.data.session.id).toBe(sessionId);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle session.list request', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.list'
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.success).toBe(true);
|
||||||
|
expect(response.body.data.sessions).toBeDefined();
|
||||||
|
expect(Array.isArray(response.body.data.sessions)).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle session.start request', async () => {
|
||||||
|
// Create a session first
|
||||||
|
const createPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const createResponse = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(createPayload);
|
||||||
|
|
||||||
|
const sessionId = createResponse.body.data.session.id;
|
||||||
|
|
||||||
|
// Start the session
|
||||||
|
const startPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.start',
|
||||||
|
sessionId
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const startResponse = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(startPayload);
|
||||||
|
|
||||||
|
expect(startResponse.status).toBe(200);
|
||||||
|
expect(startResponse.body.success).toBe(true);
|
||||||
|
expect(startResponse.body.message).toBe('Session started');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle session.output request', async () => {
|
||||||
|
// Create a session first
|
||||||
|
const createPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const createResponse = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(createPayload);
|
||||||
|
|
||||||
|
const sessionId = createResponse.body.data.session.id;
|
||||||
|
|
||||||
|
// Get session output
|
||||||
|
const outputPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.output',
|
||||||
|
sessionId
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const outputResponse = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(outputPayload);
|
||||||
|
|
||||||
|
expect(outputResponse.status).toBe(200);
|
||||||
|
expect(outputResponse.body.success).toBe(true);
|
||||||
|
expect(outputResponse.body.data.sessionId).toBe(sessionId);
|
||||||
|
expect(outputResponse.body.data.output).toBeNull(); // No output yet
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject requests without authentication', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app).post('/api/webhooks/claude').send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(401);
|
||||||
|
expect(response.body.error).toBe('Unauthorized');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject requests with invalid authentication', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer wrong-secret')
|
||||||
|
.send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(401);
|
||||||
|
expect(response.body.error).toBe('Unauthorized');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('POST /api/webhooks/claude - Orchestration', () => {
|
||||||
|
it('should create orchestration session', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build a complete e-commerce platform'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.success).toBe(true);
|
||||||
|
expect(response.body.message).toBe('Orchestration session created');
|
||||||
|
expect(response.body.data).toMatchObject({
|
||||||
|
status: 'initiated',
|
||||||
|
summary: 'Created orchestration session for owner/repo'
|
||||||
|
});
|
||||||
|
expect(response.body.data.orchestrationId).toBeDefined();
|
||||||
|
expect(response.body.data.sessions).toHaveLength(1);
|
||||||
|
expect(response.body.data.sessions[0].type).toBe('coordination');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should create orchestration session without auto-start', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
autoStart: false,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Analyze and plan implementation'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-secret')
|
||||||
|
.send(payload);
|
||||||
|
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.success).toBe(true);
|
||||||
|
expect(response.body.data.sessions[0].status).toBe('initializing');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
174
test/integration/claude/claude-webhook.test.ts
Normal file
174
test/integration/claude/claude-webhook.test.ts
Normal file
@@ -0,0 +1,174 @@
|
|||||||
|
import request from 'supertest';
|
||||||
|
import express from 'express';
|
||||||
|
|
||||||
|
// Mock child_process to prevent Docker commands
|
||||||
|
jest.mock('child_process', () => ({
|
||||||
|
execSync: jest.fn(() => ''),
|
||||||
|
spawn: jest.fn(() => ({
|
||||||
|
stdout: { on: jest.fn() },
|
||||||
|
stderr: { on: jest.fn() },
|
||||||
|
on: jest.fn((event, callback) => {
|
||||||
|
if (event === 'close') {
|
||||||
|
setTimeout(() => callback(0), 100);
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}))
|
||||||
|
}));
|
||||||
|
|
||||||
|
// Mock SessionManager to avoid Docker calls in CI
|
||||||
|
jest.mock('../../../src/providers/claude/services/SessionManager', () => {
|
||||||
|
return {
|
||||||
|
SessionManager: jest.fn().mockImplementation(() => ({
|
||||||
|
createContainer: jest.fn().mockResolvedValue('mock-container-id'),
|
||||||
|
startSession: jest.fn().mockResolvedValue(undefined),
|
||||||
|
getSession: jest.fn().mockImplementation(id => ({
|
||||||
|
id,
|
||||||
|
status: 'running',
|
||||||
|
type: 'implementation',
|
||||||
|
project: { repository: 'test/repo', requirements: 'test' },
|
||||||
|
dependencies: []
|
||||||
|
})),
|
||||||
|
listSessions: jest.fn().mockResolvedValue([]),
|
||||||
|
getSessionOutput: jest.fn().mockResolvedValue({ output: 'test output' }),
|
||||||
|
canStartSession: jest.fn().mockResolvedValue(true),
|
||||||
|
updateSessionStatus: jest.fn().mockResolvedValue(undefined)
|
||||||
|
}))
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
// Now we can import the routes
|
||||||
|
import webhookRoutes from '../../../src/routes/webhooks';
|
||||||
|
|
||||||
|
// Set environment variables for testing
|
||||||
|
process.env.CLAUDE_WEBHOOK_SECRET = 'test-claude-secret';
|
||||||
|
process.env.SKIP_WEBHOOK_VERIFICATION = '1';
|
||||||
|
|
||||||
|
describe('Claude Webhook Integration', () => {
|
||||||
|
let app: express.Application;
|
||||||
|
|
||||||
|
beforeAll(() => {
|
||||||
|
// Import provider to register handlers
|
||||||
|
require('../../../src/providers/claude');
|
||||||
|
});
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
app = express();
|
||||||
|
app.use(express.json());
|
||||||
|
app.use('/api/webhooks', webhookRoutes);
|
||||||
|
});
|
||||||
|
|
||||||
|
afterEach(() => {
|
||||||
|
jest.clearAllMocks();
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('POST /api/webhooks/claude', () => {
|
||||||
|
it('should accept valid orchestration request', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'test-owner/test-repo',
|
||||||
|
requirements: 'Build a simple REST API with authentication'
|
||||||
|
},
|
||||||
|
strategy: {
|
||||||
|
parallelSessions: 3,
|
||||||
|
phases: ['analysis', 'implementation', 'testing']
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-claude-secret')
|
||||||
|
.send(payload)
|
||||||
|
.expect(200);
|
||||||
|
|
||||||
|
expect(response.body).toMatchObject({
|
||||||
|
message: 'Webhook processed',
|
||||||
|
event: 'orchestrate'
|
||||||
|
});
|
||||||
|
|
||||||
|
expect(response.body.results).toBeDefined();
|
||||||
|
expect(response.body.results[0].success).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject request without authorization', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'test-owner/test-repo',
|
||||||
|
requirements: 'Build API'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
// Remove skip verification for this test
|
||||||
|
const originalSkip = process.env.SKIP_WEBHOOK_VERIFICATION;
|
||||||
|
delete process.env.SKIP_WEBHOOK_VERIFICATION;
|
||||||
|
|
||||||
|
const response = await request(app).post('/api/webhooks/claude').send(payload).expect(401);
|
||||||
|
|
||||||
|
expect(response.body).toMatchObject({
|
||||||
|
error: 'Unauthorized'
|
||||||
|
});
|
||||||
|
|
||||||
|
// Restore skip verification
|
||||||
|
process.env.SKIP_WEBHOOK_VERIFICATION = originalSkip;
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle session management request', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
type: 'session',
|
||||||
|
sessionId: 'test-session-123',
|
||||||
|
project: {
|
||||||
|
repository: 'test-owner/test-repo',
|
||||||
|
requirements: 'Manage session'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-claude-secret')
|
||||||
|
.send(payload)
|
||||||
|
.expect(200);
|
||||||
|
|
||||||
|
expect(response.body).toMatchObject({
|
||||||
|
message: 'Webhook processed',
|
||||||
|
event: 'session'
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject invalid payload', async () => {
|
||||||
|
const payload = {
|
||||||
|
data: {
|
||||||
|
// Missing type field
|
||||||
|
invalid: 'data'
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await request(app)
|
||||||
|
.post('/api/webhooks/claude')
|
||||||
|
.set('Authorization', 'Bearer test-claude-secret')
|
||||||
|
.send(payload)
|
||||||
|
.expect(500);
|
||||||
|
|
||||||
|
expect(response.body.error).toBeDefined();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('GET /api/webhooks/health', () => {
|
||||||
|
it('should show Claude provider in health check', async () => {
|
||||||
|
const response = await request(app).get('/api/webhooks/health').expect(200);
|
||||||
|
|
||||||
|
expect(response.body.status).toBe('healthy');
|
||||||
|
expect(response.body.providers).toBeDefined();
|
||||||
|
|
||||||
|
const claudeProvider = response.body.providers.find((p: any) => p.name === 'claude');
|
||||||
|
expect(claudeProvider).toBeDefined();
|
||||||
|
expect(claudeProvider.handlerCount).toBeGreaterThan(0);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -9,16 +9,21 @@ describe('Webhook Constants', () => {
|
|||||||
expect(ALLOWED_WEBHOOK_PROVIDERS).toContain('github');
|
expect(ALLOWED_WEBHOOK_PROVIDERS).toContain('github');
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it('should contain claude', () => {
|
||||||
|
expect(ALLOWED_WEBHOOK_PROVIDERS).toContain('claude');
|
||||||
|
});
|
||||||
|
|
||||||
it('should be a readonly array', () => {
|
it('should be a readonly array', () => {
|
||||||
// TypeScript's 'as const' makes it readonly at compile time
|
// TypeScript's 'as const' makes it readonly at compile time
|
||||||
// but not frozen at runtime
|
// but not frozen at runtime
|
||||||
expect(ALLOWED_WEBHOOK_PROVIDERS).toEqual(['github']);
|
expect(ALLOWED_WEBHOOK_PROVIDERS).toEqual(['github', 'claude']);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('isAllowedProvider', () => {
|
describe('isAllowedProvider', () => {
|
||||||
it('should return true for allowed providers', () => {
|
it('should return true for allowed providers', () => {
|
||||||
expect(isAllowedProvider('github')).toBe(true);
|
expect(isAllowedProvider('github')).toBe(true);
|
||||||
|
expect(isAllowedProvider('claude')).toBe(true);
|
||||||
});
|
});
|
||||||
|
|
||||||
it('should return false for disallowed providers', () => {
|
it('should return false for disallowed providers', () => {
|
||||||
|
|||||||
241
test/unit/providers/claude/ClaudeWebhookProvider.test.ts
Normal file
241
test/unit/providers/claude/ClaudeWebhookProvider.test.ts
Normal file
@@ -0,0 +1,241 @@
|
|||||||
|
import { ClaudeWebhookProvider } from '../../../../src/providers/claude/ClaudeWebhookProvider';
|
||||||
|
import type { ClaudeWebhookPayload } from '../../../../src/providers/claude/ClaudeWebhookProvider';
|
||||||
|
import type { WebhookRequest } from '../../../../src/types/express';
|
||||||
|
|
||||||
|
describe('ClaudeWebhookProvider', () => {
|
||||||
|
let provider: ClaudeWebhookProvider;
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
provider = new ClaudeWebhookProvider();
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('verifySignature', () => {
|
||||||
|
it('should verify valid bearer token', async () => {
|
||||||
|
const req = {
|
||||||
|
headers: {
|
||||||
|
authorization: 'Bearer test-secret'
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
const result = await provider.verifySignature(req, 'test-secret');
|
||||||
|
expect(result).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject missing authorization header', async () => {
|
||||||
|
const req = {
|
||||||
|
headers: {}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
const result = await provider.verifySignature(req, 'test-secret');
|
||||||
|
expect(result).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject invalid token', async () => {
|
||||||
|
const req = {
|
||||||
|
headers: {
|
||||||
|
authorization: 'Bearer wrong-token'
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
const result = await provider.verifySignature(req, 'test-secret');
|
||||||
|
expect(result).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should reject non-bearer auth', async () => {
|
||||||
|
const req = {
|
||||||
|
headers: {
|
||||||
|
authorization: 'Basic test-secret'
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
const result = await provider.verifySignature(req, 'test-secret');
|
||||||
|
expect(result).toBe(false);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('parsePayload', () => {
|
||||||
|
it('should parse valid orchestration request', async () => {
|
||||||
|
const req = {
|
||||||
|
body: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build a REST API'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
const result = await provider.parsePayload(req);
|
||||||
|
|
||||||
|
expect(result.event).toBe('orchestrate');
|
||||||
|
expect(result.source).toBe('claude');
|
||||||
|
expect(result.data.type).toBe('orchestrate');
|
||||||
|
expect(result.data.project.repository).toBe('owner/repo');
|
||||||
|
expect(result.data.project.requirements).toBe('Build a REST API');
|
||||||
|
expect(result.id).toBeDefined();
|
||||||
|
expect(result.timestamp).toBeDefined();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should parse session management request', async () => {
|
||||||
|
const req = {
|
||||||
|
body: {
|
||||||
|
type: 'session',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Manage session'
|
||||||
|
},
|
||||||
|
sessionId: 'test-session-123'
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
const result = await provider.parsePayload(req);
|
||||||
|
|
||||||
|
expect(result.event).toBe('session');
|
||||||
|
expect(result.data.type).toBe('session');
|
||||||
|
expect(result.data.sessionId).toBe('test-session-123');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should parse session.create payload', async () => {
|
||||||
|
const req = {
|
||||||
|
body: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
const result = await provider.parsePayload(req);
|
||||||
|
|
||||||
|
expect(result.event).toBe('session.create');
|
||||||
|
expect(result.data.type).toBe('session.create');
|
||||||
|
expect(result.data.session).toBeDefined();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should throw on missing session field for session.create', async () => {
|
||||||
|
const req = {
|
||||||
|
body: {
|
||||||
|
type: 'session.create'
|
||||||
|
// Missing session
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
await expect(provider.parsePayload(req)).rejects.toThrow(
|
||||||
|
'Invalid payload: missing session field'
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should throw on missing required fields', async () => {
|
||||||
|
const req = {
|
||||||
|
body: {
|
||||||
|
type: 'orchestrate'
|
||||||
|
// Missing project
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
await expect(provider.parsePayload(req)).rejects.toThrow(
|
||||||
|
'Invalid payload: missing required project fields'
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should throw on missing repository', async () => {
|
||||||
|
const req = {
|
||||||
|
body: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
requirements: 'Build something'
|
||||||
|
// Missing repository
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} as WebhookRequest;
|
||||||
|
|
||||||
|
await expect(provider.parsePayload(req)).rejects.toThrow(
|
||||||
|
'Invalid payload: missing required project fields'
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('getEventType', () => {
|
||||||
|
it('should return the event type', () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
id: 'test-id',
|
||||||
|
timestamp: new Date().toISOString(),
|
||||||
|
event: 'orchestrate',
|
||||||
|
source: 'claude',
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build API'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
expect(provider.getEventType(payload)).toBe('orchestrate');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('getEventDescription', () => {
|
||||||
|
it('should describe orchestrate event', () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
id: 'test-id',
|
||||||
|
timestamp: new Date().toISOString(),
|
||||||
|
event: 'orchestrate',
|
||||||
|
source: 'claude',
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build API'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
expect(provider.getEventDescription(payload)).toBe(
|
||||||
|
'Orchestrate Claude sessions for owner/repo'
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should describe session event', () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
id: 'test-id',
|
||||||
|
timestamp: new Date().toISOString(),
|
||||||
|
event: 'session',
|
||||||
|
source: 'claude',
|
||||||
|
data: {
|
||||||
|
type: 'session',
|
||||||
|
sessionId: 'session-123',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Manage session'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
expect(provider.getEventDescription(payload)).toBe('Manage Claude session session-123');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should describe coordinate event', () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
id: 'test-id',
|
||||||
|
timestamp: new Date().toISOString(),
|
||||||
|
event: 'coordinate',
|
||||||
|
source: 'claude',
|
||||||
|
data: {
|
||||||
|
type: 'coordinate',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Coordinate sessions'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
expect(provider.getEventDescription(payload)).toBe(
|
||||||
|
'Coordinate Claude sessions for owner/repo'
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
186
test/unit/providers/claude/handlers/OrchestrationHandler.test.ts
Normal file
186
test/unit/providers/claude/handlers/OrchestrationHandler.test.ts
Normal file
@@ -0,0 +1,186 @@
|
|||||||
|
import { OrchestrationHandler } from '../../../../../src/providers/claude/handlers/OrchestrationHandler';
|
||||||
|
import type { SessionManager } from '../../../../../src/providers/claude/services/SessionManager';
|
||||||
|
import type { ClaudeWebhookPayload } from '../../../../../src/providers/claude/ClaudeWebhookProvider';
|
||||||
|
import type { WebhookContext } from '../../../../../src/types/webhook';
|
||||||
|
|
||||||
|
// Mock the services
|
||||||
|
jest.mock('../../../../../src/providers/claude/services/SessionManager');
|
||||||
|
|
||||||
|
describe('OrchestrationHandler', () => {
|
||||||
|
let handler: OrchestrationHandler;
|
||||||
|
let mockSessionManager: jest.Mocked<SessionManager>;
|
||||||
|
let mockContext: WebhookContext;
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
jest.clearAllMocks();
|
||||||
|
handler = new OrchestrationHandler();
|
||||||
|
mockSessionManager = (handler as any).sessionManager;
|
||||||
|
mockContext = {
|
||||||
|
provider: 'claude',
|
||||||
|
timestamp: new Date()
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('canHandle', () => {
|
||||||
|
it('should handle orchestrate events', () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build API'
|
||||||
|
}
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
expect(handler.canHandle(payload)).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should not handle session events', () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Manage session'
|
||||||
|
}
|
||||||
|
} as any,
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
expect(handler.canHandle(payload)).toBe(false);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('handle', () => {
|
||||||
|
it('should create orchestration session and start it by default', async () => {
|
||||||
|
mockSessionManager.createContainer.mockResolvedValue('container-123');
|
||||||
|
mockSessionManager.startSession.mockResolvedValue();
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build a REST API with authentication'
|
||||||
|
}
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.message).toBe('Orchestration session created');
|
||||||
|
expect(response.data).toMatchObject({
|
||||||
|
status: 'initiated',
|
||||||
|
summary: 'Created orchestration session for owner/repo'
|
||||||
|
});
|
||||||
|
|
||||||
|
// Verify session creation
|
||||||
|
const createdSession = mockSessionManager.createContainer.mock.calls[0][0];
|
||||||
|
expect(createdSession).toMatchObject({
|
||||||
|
type: 'coordination',
|
||||||
|
status: 'pending',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build a REST API with authentication'
|
||||||
|
},
|
||||||
|
dependencies: []
|
||||||
|
});
|
||||||
|
|
||||||
|
// Verify session was started
|
||||||
|
expect(mockSessionManager.startSession).toHaveBeenCalled();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should use custom session type when provided', async () => {
|
||||||
|
mockSessionManager.createContainer.mockResolvedValue('container-123');
|
||||||
|
mockSessionManager.startSession.mockResolvedValue();
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
sessionType: 'analysis',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Analyze codebase structure'
|
||||||
|
}
|
||||||
|
} as any,
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
|
||||||
|
const createdSession = mockSessionManager.createContainer.mock.calls[0][0];
|
||||||
|
expect(createdSession.type).toBe('analysis');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should not start session when autoStart is false', async () => {
|
||||||
|
mockSessionManager.createContainer.mockResolvedValue('container-123');
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
autoStart: false,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build API'
|
||||||
|
}
|
||||||
|
} as any,
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(mockSessionManager.createContainer).toHaveBeenCalled();
|
||||||
|
expect(mockSessionManager.startSession).not.toHaveBeenCalled();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle errors gracefully', async () => {
|
||||||
|
mockSessionManager.createContainer.mockRejectedValue(new Error('Docker error'));
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build API'
|
||||||
|
}
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(false);
|
||||||
|
expect(response.error).toBe('Docker error');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should generate unique orchestration IDs', async () => {
|
||||||
|
mockSessionManager.createContainer.mockResolvedValue('container-123');
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'orchestrate',
|
||||||
|
autoStart: false,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build API'
|
||||||
|
}
|
||||||
|
} as any,
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response1 = await handler.handle(payload, mockContext);
|
||||||
|
const response2 = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response1.data?.orchestrationId).toBeDefined();
|
||||||
|
expect(response2.data?.orchestrationId).toBeDefined();
|
||||||
|
expect(response1.data?.orchestrationId).not.toBe(response2.data?.orchestrationId);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
433
test/unit/providers/claude/handlers/SessionHandler.test.ts
Normal file
433
test/unit/providers/claude/handlers/SessionHandler.test.ts
Normal file
@@ -0,0 +1,433 @@
|
|||||||
|
import { SessionHandler } from '../../../../../src/providers/claude/handlers/SessionHandler';
|
||||||
|
import type { SessionManager } from '../../../../../src/providers/claude/services/SessionManager';
|
||||||
|
import type { ClaudeWebhookPayload } from '../../../../../src/providers/claude/ClaudeWebhookProvider';
|
||||||
|
import type { WebhookContext } from '../../../../../src/types/webhook';
|
||||||
|
|
||||||
|
// Mock SessionManager
|
||||||
|
jest.mock('../../../../../src/providers/claude/services/SessionManager');
|
||||||
|
|
||||||
|
describe('SessionHandler', () => {
|
||||||
|
let handler: SessionHandler;
|
||||||
|
let mockSessionManager: jest.Mocked<SessionManager>;
|
||||||
|
let mockContext: WebhookContext;
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
jest.clearAllMocks();
|
||||||
|
handler = new SessionHandler();
|
||||||
|
mockSessionManager = (handler as any).sessionManager;
|
||||||
|
mockContext = {
|
||||||
|
provider: 'claude',
|
||||||
|
timestamp: new Date()
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('canHandle', () => {
|
||||||
|
it('should handle session.* events', () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: { type: 'session.create' } as any,
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
expect(handler.canHandle(payload)).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should not handle non-session events', () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: { type: 'orchestrate' } as any,
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
expect(handler.canHandle(payload)).toBe(false);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('session.create', () => {
|
||||||
|
it('should create a new session', async () => {
|
||||||
|
mockSessionManager.createContainer.mockResolvedValue('container-123');
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.data?.session).toMatchObject({
|
||||||
|
type: 'implementation',
|
||||||
|
status: 'initializing',
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
},
|
||||||
|
containerId: 'container-123'
|
||||||
|
});
|
||||||
|
expect(mockSessionManager.createContainer).toHaveBeenCalled();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should fail without repository', async () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
} as any
|
||||||
|
}
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(false);
|
||||||
|
expect(response.error).toBe('Repository is required for session creation');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should fail without requirements', async () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo'
|
||||||
|
} as any
|
||||||
|
}
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(false);
|
||||||
|
expect(response.error).toBe('Requirements are required for session creation');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('session.get', () => {
|
||||||
|
it('should get existing session', async () => {
|
||||||
|
const mockSession = {
|
||||||
|
id: 'test-session-123',
|
||||||
|
type: 'implementation' as const,
|
||||||
|
status: 'running' as const,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
},
|
||||||
|
dependencies: []
|
||||||
|
};
|
||||||
|
|
||||||
|
mockSessionManager.getSession.mockReturnValue(mockSession);
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.get',
|
||||||
|
sessionId: 'test-session-123'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.data?.session).toEqual(mockSession);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should return error for non-existent session', async () => {
|
||||||
|
mockSessionManager.getSession.mockReturnValue(undefined);
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.get',
|
||||||
|
sessionId: 'non-existent'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(false);
|
||||||
|
expect(response.error).toBe('Session not found: non-existent');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('session.list', () => {
|
||||||
|
it('should list all sessions', async () => {
|
||||||
|
const mockSessions = [
|
||||||
|
{
|
||||||
|
id: 'session-1',
|
||||||
|
type: 'implementation' as const,
|
||||||
|
status: 'running' as const,
|
||||||
|
project: { repository: 'owner/repo', requirements: 'Test' },
|
||||||
|
dependencies: []
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: 'session-2',
|
||||||
|
type: 'testing' as const,
|
||||||
|
status: 'pending' as const,
|
||||||
|
project: { repository: 'owner/repo', requirements: 'Test' },
|
||||||
|
dependencies: ['session-1']
|
||||||
|
}
|
||||||
|
];
|
||||||
|
|
||||||
|
mockSessionManager.getAllSessions.mockReturnValue(mockSessions);
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.list'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.data?.sessions).toEqual(mockSessions);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should list sessions by orchestration ID', async () => {
|
||||||
|
const mockSessions = [
|
||||||
|
{
|
||||||
|
id: 'orch-123-impl',
|
||||||
|
type: 'implementation' as const,
|
||||||
|
status: 'running' as const,
|
||||||
|
project: { repository: 'owner/repo', requirements: 'Test' },
|
||||||
|
dependencies: []
|
||||||
|
}
|
||||||
|
];
|
||||||
|
|
||||||
|
mockSessionManager.getOrchestrationSessions.mockReturnValue(mockSessions);
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.list',
|
||||||
|
orchestrationId: 'orch-123'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.data?.sessions).toEqual(mockSessions);
|
||||||
|
expect(mockSessionManager.getOrchestrationSessions).toHaveBeenCalledWith('orch-123');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('session.start', () => {
|
||||||
|
it('should start a session without dependencies', async () => {
|
||||||
|
const mockSession = {
|
||||||
|
id: 'test-session-123',
|
||||||
|
type: 'implementation' as const,
|
||||||
|
status: 'initializing' as const,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
},
|
||||||
|
dependencies: []
|
||||||
|
};
|
||||||
|
|
||||||
|
mockSessionManager.getSession.mockReturnValue(mockSession);
|
||||||
|
mockSessionManager.startSession.mockResolvedValue();
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.start',
|
||||||
|
sessionId: 'test-session-123'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.message).toBe('Session started');
|
||||||
|
expect(mockSessionManager.startSession).toHaveBeenCalledWith(mockSession);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should queue session with unmet dependencies', async () => {
|
||||||
|
const mockSession = {
|
||||||
|
id: 'test-session-123',
|
||||||
|
type: 'testing' as const,
|
||||||
|
status: 'pending' as const,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
},
|
||||||
|
dependencies: ['dep-1', 'dep-2']
|
||||||
|
};
|
||||||
|
|
||||||
|
const mockDep1 = {
|
||||||
|
id: 'dep-1',
|
||||||
|
status: 'completed' as const
|
||||||
|
};
|
||||||
|
|
||||||
|
const mockDep2 = {
|
||||||
|
id: 'dep-2',
|
||||||
|
status: 'running' as const // Not completed
|
||||||
|
};
|
||||||
|
|
||||||
|
mockSessionManager.getSession
|
||||||
|
.mockReturnValueOnce(mockSession)
|
||||||
|
.mockReturnValueOnce(mockDep1 as any)
|
||||||
|
.mockReturnValueOnce(mockDep2 as any);
|
||||||
|
mockSessionManager.queueSession.mockResolvedValue();
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.start',
|
||||||
|
sessionId: 'test-session-123'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.message).toBe('Session queued, waiting for dependencies');
|
||||||
|
expect(response.data?.waitingFor).toEqual(['dep-2']);
|
||||||
|
expect(mockSessionManager.queueSession).toHaveBeenCalledWith(mockSession);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should fail for invalid session status', async () => {
|
||||||
|
const mockSession = {
|
||||||
|
id: 'test-session-123',
|
||||||
|
type: 'implementation' as const,
|
||||||
|
status: 'completed' as const,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
},
|
||||||
|
dependencies: []
|
||||||
|
};
|
||||||
|
|
||||||
|
mockSessionManager.getSession.mockReturnValue(mockSession);
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.start',
|
||||||
|
sessionId: 'test-session-123'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(false);
|
||||||
|
expect(response.error).toBe('Session cannot be started in status: completed');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('session.output', () => {
|
||||||
|
it('should get session output', async () => {
|
||||||
|
const mockOutput = {
|
||||||
|
logs: ['Line 1', 'Line 2'],
|
||||||
|
artifacts: [{ type: 'file' as const, path: 'src/test.ts' }],
|
||||||
|
summary: 'Task completed',
|
||||||
|
nextSteps: ['Run tests']
|
||||||
|
};
|
||||||
|
|
||||||
|
const mockSession = {
|
||||||
|
id: 'test-session-123',
|
||||||
|
type: 'implementation' as const,
|
||||||
|
status: 'completed' as const,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
},
|
||||||
|
dependencies: [],
|
||||||
|
output: mockOutput
|
||||||
|
};
|
||||||
|
|
||||||
|
mockSessionManager.getSession.mockReturnValue(mockSession);
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.output',
|
||||||
|
sessionId: 'test-session-123'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.data?.output).toEqual(mockOutput);
|
||||||
|
expect(response.data?.status).toBe('completed');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle session without output', async () => {
|
||||||
|
const mockSession = {
|
||||||
|
id: 'test-session-123',
|
||||||
|
type: 'implementation' as const,
|
||||||
|
status: 'running' as const,
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
},
|
||||||
|
dependencies: [],
|
||||||
|
output: undefined
|
||||||
|
};
|
||||||
|
|
||||||
|
mockSessionManager.getSession.mockReturnValue(mockSession);
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.output',
|
||||||
|
sessionId: 'test-session-123'
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(true);
|
||||||
|
expect(response.data?.output).toBeNull();
|
||||||
|
expect(response.data?.message).toBe('Session has no output yet');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('error handling', () => {
|
||||||
|
it('should handle unknown session operation', async () => {
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.unknown'
|
||||||
|
} as any,
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(false);
|
||||||
|
expect(response.error).toBe('Unknown session operation: session.unknown');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle errors gracefully', async () => {
|
||||||
|
mockSessionManager.createContainer.mockRejectedValue(new Error('Docker error'));
|
||||||
|
|
||||||
|
const payload: ClaudeWebhookPayload = {
|
||||||
|
data: {
|
||||||
|
type: 'session.create',
|
||||||
|
session: {
|
||||||
|
project: {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Test requirements'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
metadata: {}
|
||||||
|
};
|
||||||
|
|
||||||
|
const response = await handler.handle(payload, mockContext);
|
||||||
|
|
||||||
|
expect(response.success).toBe(false);
|
||||||
|
expect(response.error).toBe('Docker error');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
152
test/unit/providers/claude/services/TaskDecomposer.test.ts
Normal file
152
test/unit/providers/claude/services/TaskDecomposer.test.ts
Normal file
@@ -0,0 +1,152 @@
|
|||||||
|
import { TaskDecomposer } from '../../../../../src/providers/claude/services/TaskDecomposer';
|
||||||
|
import type { ProjectInfo } from '../../../../../src/types/claude-orchestration';
|
||||||
|
|
||||||
|
describe('TaskDecomposer', () => {
|
||||||
|
let decomposer: TaskDecomposer;
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
decomposer = new TaskDecomposer();
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('decompose', () => {
|
||||||
|
it('should decompose API project into components', () => {
|
||||||
|
const project: ProjectInfo = {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build a REST API with authentication and database integration'
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = decomposer.decompose(project);
|
||||||
|
|
||||||
|
expect(result.components).toBeDefined();
|
||||||
|
expect(result.components.length).toBeGreaterThan(0);
|
||||||
|
|
||||||
|
// Should identify API, auth, and backend components
|
||||||
|
const componentNames = result.components.map(c => c.name);
|
||||||
|
expect(componentNames).toContain('api');
|
||||||
|
expect(componentNames).toContain('auth');
|
||||||
|
expect(componentNames).toContain('backend');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should decompose frontend project', () => {
|
||||||
|
const project: ProjectInfo = {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Create a React frontend with user interface for managing tasks'
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = decomposer.decompose(project);
|
||||||
|
|
||||||
|
const componentNames = result.components.map(c => c.name);
|
||||||
|
expect(componentNames).toContain('frontend');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle full-stack project', () => {
|
||||||
|
const project: ProjectInfo = {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements:
|
||||||
|
'Build a full-stack application with React frontend, Express backend, PostgreSQL database, JWT authentication, and comprehensive testing'
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = decomposer.decompose(project);
|
||||||
|
|
||||||
|
const componentNames = result.components.map(c => c.name);
|
||||||
|
expect(componentNames).toContain('frontend');
|
||||||
|
expect(componentNames).toContain('backend');
|
||||||
|
expect(componentNames).toContain('auth');
|
||||||
|
expect(componentNames).toContain('testing');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should set proper dependencies', () => {
|
||||||
|
const project: ProjectInfo = {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build API server with database backend, frontend UI, and testing'
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = decomposer.decompose(project);
|
||||||
|
|
||||||
|
// Find components
|
||||||
|
const api = result.components.find(c => c.name === 'api');
|
||||||
|
const backend = result.components.find(c => c.name === 'backend');
|
||||||
|
const frontend = result.components.find(c => c.name === 'frontend');
|
||||||
|
const testing = result.components.find(c => c.name === 'testing');
|
||||||
|
|
||||||
|
// Check backend exists
|
||||||
|
expect(backend).toBeDefined();
|
||||||
|
|
||||||
|
// Check dependencies
|
||||||
|
if (api) {
|
||||||
|
expect(api.dependencies).toContain('backend');
|
||||||
|
}
|
||||||
|
if (frontend) {
|
||||||
|
expect(frontend.dependencies).toContain('api');
|
||||||
|
}
|
||||||
|
if (testing) {
|
||||||
|
expect(testing.dependencies.length).toBeGreaterThan(0);
|
||||||
|
expect(testing.dependencies).toContain('api');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should handle simple requirements', () => {
|
||||||
|
const project: ProjectInfo = {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Fix a bug in the code'
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = decomposer.decompose(project);
|
||||||
|
|
||||||
|
expect(result.components.length).toBe(1);
|
||||||
|
expect(result.components[0].name).toBe('implementation');
|
||||||
|
expect(result.components[0].requirements).toBe('Fix a bug in the code');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should determine strategy based on components', () => {
|
||||||
|
const project: ProjectInfo = {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements: 'Build API with frontend, backend, auth, and deployment'
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = decomposer.decompose(project);
|
||||||
|
|
||||||
|
// Should use wait_for_core strategy due to dependencies
|
||||||
|
expect(result.strategy).toBe('wait_for_core');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should extract component-specific requirements', () => {
|
||||||
|
const project: ProjectInfo = {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements:
|
||||||
|
'Build a REST API with endpoints for user management. Add JWT authentication for secure access. Create a React frontend with Material UI.'
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = decomposer.decompose(project);
|
||||||
|
|
||||||
|
const api = result.components.find(c => c.name === 'api');
|
||||||
|
const auth = result.components.find(c => c.name === 'auth');
|
||||||
|
const frontend = result.components.find(c => c.name === 'frontend');
|
||||||
|
|
||||||
|
expect(api?.requirements).toContain('REST API');
|
||||||
|
expect(api?.requirements).toContain('endpoints');
|
||||||
|
expect(auth?.requirements).toContain('JWT authentication');
|
||||||
|
expect(frontend?.requirements).toContain('React frontend');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should set appropriate priorities', () => {
|
||||||
|
const project: ProjectInfo = {
|
||||||
|
repository: 'owner/repo',
|
||||||
|
requirements:
|
||||||
|
'Build backend with database, API endpoints, authentication, frontend UI, and deployment scripts'
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = decomposer.decompose(project);
|
||||||
|
|
||||||
|
const backend = result.components.find(c => c.name === 'backend');
|
||||||
|
const auth = result.components.find(c => c.name === 'auth');
|
||||||
|
const frontend = result.components.find(c => c.name === 'frontend');
|
||||||
|
const deployment = result.components.find(c => c.name === 'deployment');
|
||||||
|
|
||||||
|
expect(backend?.priority).toBe('high');
|
||||||
|
expect(auth?.priority).toBe('high');
|
||||||
|
expect(frontend?.priority).toBe('medium');
|
||||||
|
expect(deployment?.priority).toBe('low');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
Reference in New Issue
Block a user