Merge pull request #4 from kagenti/orchestrate/precommit

Add pre-commit hooks and code quality baseline

Author: kellyaa

.claude/settings.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git status:*)",
+      "Bash(git log:*)",
+      "Bash(git diff:*)",
+      "Bash(git branch:*)",
+      "Bash(ls:*)",
+      "Bash(cat:*)",
+      "Bash(find:*)",
+      "Bash(make lint:*)",
+      "Bash(make fmt:*)",
+      "Bash(pre-commit run:*)",
+      "Bash(cd appworld_a2a_runner && pytest:*)",
+      "Bash(ruff:*)"
+    ]
+  }
+}

.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

CLAUDE.md

@@ -0,0 +1,54 @@
+# Kagenti Workload Harness
+
+## Overview
+
+Workload harnesses for driving test and evaluation traffic to Kagenti agents.
+Currently includes the AppWorld harness as the first supported workload driver,
+designed to expand to additional drivers over time.
+
+## Repository Structure
+
+```
+workload-harness/
+├── appworld_a2a_runner/          # AppWorld A2A workload driver
+│   ├── appworld_a2a_runner/      # Python package
+│   │   ├── runner.py             # Main runner entrypoint
+│   │   ├── config.py             # Configuration
+│   │   ├── a2a_client.py         # A2A protocol client
+│   │   ├── appworld_adapter.py   # AppWorld integration
+│   │   ├── prompt.py             # Prompt handling
+│   │   └── otel.py               # OpenTelemetry instrumentation
+│   └── pyproject.toml            # Package dependencies
+├── pyproject.toml                # Root lint config (ruff)
+└── example.env                   # Environment variable template
+```
+
+## Key Commands
+
+| Task | Command |
+|------|---------|
+| Lint | `make lint` |
+| Format | `make fmt` |
+| Test | `cd appworld_a2a_runner && pytest` |
+| Run | `appworld-a2a-runner` (after install) |
+| Install | `cd appworld_a2a_runner && pip install -e .` |
+
+## Code Style
+
+- Python 3.11+ with ruff (lint + format)
+- Pre-commit hooks: `pre-commit install`
+- Line length: 120
+
+## DCO Sign-Off
+
+All commits must include a `Signed-off-by` trailer:
+
+```sh
+git commit -s -m "feat: add new feature"
+```
+
+## Commit Attribution
+
+Use `Assisted-By` for AI attribution (not `Co-Authored-By`):
+
+    Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com>

Makefile

@@ -0,0 +1,8 @@
+.PHONY: lint fmt
+
+lint:
+	pre-commit run --all-files
+
+fmt:
+	ruff format .
+	ruff check --fix .

appworld_a2a_runner/.gitignore

@@ -135,4 +135,4 @@ Thumbs.db
 
 # Project specific
 results.jsonl
-*.log
+*.log