Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ name: CI
on:
push:
branches:
- 'master'
- 'main'
tags:
- '*'
pull_request:
Expand Down
6 changes: 5 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -287,4 +287,8 @@ __pycache__/
*.private.json

# BenchmarkDotNet
BenchmarkDotNet.Artifacts
BenchmarkDotNet.Artifacts

# Playwright screenshots
*.png
*.jpeg
8 changes: 8 additions & 0 deletions .mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-server-playwright@latest"]
}
}
}
87 changes: 87 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
# Claude Code Instructions

## Project Overview

This is a .NET library (NuGet packages) extending Azure Durable Task Framework.
Multi-target: net10.0, net9.0, net8.0. Frontend: React 18 + MUI 5 + TypeScript.

## Development Workflow

Before every commit, follow this sequence:

### 1. Build

```bash
dotnet build
```

Must pass with **0 warnings and 0 errors**.

### 2. Unit Tests

```bash
dotnet test --filter "FullyQualifiedName~InMemory" --no-build
```

InMemory tests run without Docker. All 3 TFMs (net10.0, net9.0, net8.0) must pass.

### 3. UI Smoke Test via Aspire

Start all services at once using the Aspire AppHost:

```bash
dotnet run --project samples/AppHost/AppHost.csproj
```

This starts: Server, Api, Ui, OrchestrationWorker, CarWorker, FlightWorker, HotelWorker, BpmnWorker.

Then use Playwright to verify the UI:
1. Navigate to the UI (https://localhost:5002)
2. Verify the home page loads ("Welcome to Durable Task UI")
3. Navigate to Orchestrations page - verify table renders
4. Create a **BookParallel** orchestration (Name: `BookParallel`, Version: `v1`, Input: `{}`)
5. Wait a few seconds for workers to process it
6. Refresh and verify Status changes to **Completed**
7. Check the History tab - verify the full execution flow is visible
8. Take screenshots as evidence

After verification, stop the Aspire process.

### 4. Commit

Only commit after all steps above pass successfully.

## Package Versioning Rules

Since src/ projects are **published NuGet libraries**:

- **Microsoft.Extensions.\*** and **Microsoft.EntityFrameworkCore.\*** must stay at the **minimum
compatible version** for each TFM (e.g., 10.0.0 not 10.0.3 for net10.0). This maximizes
compatibility for consumers.
- **Non-framework packages** (DurableTask.Core, gRPC, Protobuf, SourceLink, etc.) should be
updated to latest stable versions.
- **Test, sample, and benchmark projects** (not published) can use latest versions freely.

## Key Commands

```bash
# Full test suite (requires Docker for MySQL, PostgreSQL, SQL Server, Azurite)
docker compose up -d
dotnet test

# Just InMemory tests (no Docker needed)
dotnet test --filter "FullyQualifiedName~InMemory"

# UI frontend (in src/LLL.DurableTask.Ui/app/)
yarn install
yarn build

# Run all samples via Aspire
dotnet run --project samples/AppHost/AppHost.csproj
```

## CI/CD

- GitHub Actions: `.github/workflows/build.yml`
- Triggers on push to `main` branch and `v*` tags
- Release: tag with `v*` to publish to NuGet