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
23 changes: 18 additions & 5 deletions .ai/00_PROJECT.md
Original file line number Diff line number Diff line change
Expand Up @@ -262,8 +262,8 @@ This means:
| Test Data | Manual datasets only | ✅ Synthetic generation |
| Retriever Providers | ChromaDB only | ✅ 11 providers (Chroma, Qdrant, Pinecone, Weaviate, FAISS, pgvector, Elasticsearch, BM25, HTTP, Memory, Mock) |
| NLI Metrics | None | ✅ DeBERTa-based faithfulness, relevancy scoring |
| CLI Commands | init, run, report, compare, list, doctor | ✅ + validate, delete, diagnose, audit, synth, completion |
| CI/CD Integration | None | Pytest plugin (planned) |
| CLI Commands | init, run, report, compare, list, doctor | ✅ + validate, delete, diagnose, audit, synth, test, completion |
| CI/CD Integration | None | Pytest plugin, threshold gating, GitHub Actions workflow |
| Production Monitoring | None | Live traffic sampling (planned) |

---
Expand Down Expand Up @@ -606,6 +606,22 @@ Generate adversarial test cases.

---

```bash
oaeval test config.yaml -t faithfulness:gte:0.8
```

Run evaluation as CI/CD test with threshold gating.

---

```bash
oaeval test config.yaml -t faithfulness:gte:0.8 -t answer_relevancy:gte:0.7 --json
```

Run evaluation with multiple thresholds and JSON output.

---

```bash
oaeval ui
```
Expand Down Expand Up @@ -729,8 +745,6 @@ Avoid tightly coupling metrics, providers, and report generators.
Version 1.0 (Stable Release):

* Generic LLM-as-Judge for custom criteria
* CI/CD Pytest Plugin
* GitHub Actions workflow example
* **Hybrid CLI UI** (Rich banner + Textual TUI dashboard)

Version 2.0:
Expand All @@ -745,7 +759,6 @@ Version 2.0:

Version 3.0:

* CI/CD integration
* GitHub Action
* Cloud synchronization
* Hosted evaluation platform
Expand Down
12 changes: 10 additions & 2 deletions .ai/02_AGENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
| **Package** | openagent_eval |
| **CLI** | oaeval |
| **Purpose** | Open-source CLI framework for evaluating RAG systems and AI Agents |
| **Phase** | v0.3.0 - Phases 1-12 Complete |
| **Phase** | v0.3.0 - Phases 1-13 Complete |
| **Status** | Active Development |
| **Source of Truth** | PROJECT.md |

Expand Down Expand Up @@ -520,6 +520,7 @@ class MetricResult:
| `oaeval audit --corpus ./kb/` | Audit corpus for contradictions, staleness |
| `oaeval diagnose --report report.json` | Diagnose failures and attribute blame |
| `oaeval synth --corpus ./kb/ --count 100` | Generate synthetic test cases |
| `oaeval test config.yaml -t faithfulness:gte:0.8` | Run evaluation as CI/CD test with threshold gating |
| `oaeval completion <shell>` | Generate shell completion (bash, zsh, fish) |

---
Expand Down Expand Up @@ -649,7 +650,14 @@ openagent_eval/
- NLI metrics (NLIJudge, ClaimExtractor, EvidenceFinder)
- PDF dataset loader

### Phase 13: Hybrid CLI UI (Planned)
### Phase 13: CI/CD Integration ✅
- [x] Implement pytest plugin for RAG evaluation
- [x] Add threshold-based test gating
- [x] Add `oaeval test` CLI command
- [x] Write documentation for CI/CD integration
- [x] Add GitHub Actions workflow example

### Phase 14: Hybrid CLI UI (Planned)
- [ ] Add `pyfiglet` and `textual` to optional dependencies
- [ ] Create `openagent_eval/cli/banner.py` — ASCII art banner with Rich
- [ ] Create `openagent_eval/ui/` module structure
Expand Down
21 changes: 12 additions & 9 deletions .ai/03_CONTEXT.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@

| Field | Value |
|-------|-------|
| **Phase** | Phase 12 Complete — Synthetic Test Data |
| **Phase** | Phase 13 Complete — CI/CD Integration |
| **Status** | v1.0 complete; production-grade features in progress |
| **Last Updated** | 2026-07-11 |
| **Next Action** | Phase 13 (CI/CD Integration) or another feature |
| **Current Branch** | feature/synthetic-test-data |
| **Next Action** | Phase 14 (Hybrid CLI UI) or another feature |
| **Current Branch** | feature/cicd-integration |
| **Remote** | https://github.com/OpenAgentHQ/openagent-eval.git |

---
Expand Down Expand Up @@ -206,11 +206,12 @@ SDK (openagent_eval - Core Evaluation API)
- [x] Write unit tests for synthetic generation (49 tests)
- [x] Write integration test for synthetic data pipeline (7 tests)

### Milestone 13: CI/CD Integration (NEW)
- [ ] Implement pytest plugin for RAG evaluation
- [ ] Add threshold-based test gating
- [ ] Add `oaeval test` CLI command
- [ ] Write documentation for CI/CD integration
### Milestone 13: CI/CD Integration (NEW) — COMPLETE
- [x] Implement pytest plugin for RAG evaluation
- [x] Add threshold-based test gating
- [x] Add `oaeval test` CLI command
- [x] Write documentation for CI/CD integration
- [x] Add GitHub Actions workflow example

---

Expand Down Expand Up @@ -278,12 +279,13 @@ chore/{description} # Maintenance tasks
- Phase 7 is complete - Evaluation pipeline is now functional (was a stub)
- Phase 8 is pending - Documentation
- **Phase 9-13 are NEW** — Production-grade RAG evaluation features
- **Phase 13 is COMPLETE** — CI/CD Integration (pytest plugin, threshold gating, `oaeval test` command)
- **Phase 12 is COMPLETE** — Synthetic Test Data generator implemented (56 tests)
- CORRECTION: earlier "517+ passing / all phases complete" status was inaccurate —
the core pipeline did not actually evaluate. That gap is closed.
- `oaeval run` now produces real answers, computed metrics, token usage, and latency.
- Offline dry-run works via `llm.provider: mock` + `retriever.provider: mock`.
- Ready to proceed with Phase 8 (Documentation), Phase 9 (Corpus Auditor), or Phase 13 (CI/CD).
- Ready to proceed with Phase 8 (Documentation), Phase 9 (Corpus Auditor), or Phase 14 (Hybrid CLI UI).

## Competitive Advantage

Expand Down Expand Up @@ -320,6 +322,7 @@ chore/{description} # Maintenance tasks

| Date | Change |
|------|--------|
| 2026-07-11 | **Phase 13 COMPLETE** — CI/CD Integration implemented (pytest plugin, threshold gating, `oaeval test` command) |
| 2026-07-11 | **Phase 12 COMPLETE** — Synthetic Test Data generator implemented (56 tests) |
| 2026-07-11 | Added Phase 14: Hybrid CLI UI (Rich banner + Textual TUI dashboard) |
| 2026-07-11 | Added CLI UI research findings to context |
Expand Down
20 changes: 14 additions & 6 deletions .ai/05_TASKS.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,12 +67,12 @@
- [x] Write unit tests for synthetic generation (49 tests)
- [x] Write integration test for synthetic data pipeline (7 tests)

### Phase 13: CI/CD Integration
- [ ] Implement pytest plugin for RAG evaluation
- [ ] Add threshold-based test gating
- [ ] Add `oaeval test` CLI command
- [ ] Write documentation for CI/CD integration
- [ ] Add GitHub Actions workflow example
### Phase 13: CI/CD Integration — COMPLETE
- [x] Implement pytest plugin for RAG evaluation
- [x] Add threshold-based test gating
- [x] Add `oaeval test` CLI command
- [x] Write documentation for CI/CD integration
- [x] Add GitHub Actions workflow example

### Phase 14: Hybrid CLI UI
- [ ] 14.1 Add `pyfiglet` and `textual` to optional dependencies
Expand All @@ -96,6 +96,13 @@

## COMPLETED

### Phase 13: CI/CD Integration
- [x] Implement pytest plugin for RAG evaluation
- [x] Add threshold-based test gating
- [x] Add `oaeval test` CLI command
- [x] Write documentation for CI/CD integration
- [x] Add GitHub Actions workflow example

### Phase 12: Synthetic Test Data
- [x] Implement `QuestionGenerator` (generate questions from documents)
- [x] Implement `AdversarialTestCaseGenerator` (tricky edge cases)
Expand Down Expand Up @@ -275,6 +282,7 @@ Phase 14 (Hybrid CLI UI) ← depends on Phase 1 (new module, independent)

| Date | Change |
|------|--------|
| 2026-07-11 | **Phase 13 COMPLETE** — CI/CD Integration implemented (pytest plugin, threshold gating, `oaeval test` command) |
| 2026-07-11 | **Phase 12 COMPLETE** — Synthetic Test Data generator implemented (56 tests) |
| 2026-07-11 | Added Phase 14: Hybrid CLI UI (Rich banner + Textual TUI dashboard) |
| 2026-07-11 | Added Phase 9-13: Corpus Auditor, LLM-as-Judge, Diagnosis, Synthetic Data, CI/CD |
Expand Down
Loading
Loading