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
40 changes: 40 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,46 @@

All notable changes to Pharabius are documented in this file.

## [3.9.0] - Unreleased

### Candidate Promotion Gate

Defines eligibility rules for promoting candidate findings to accepted findings.
Gate-only: checks eligibility without performing promotion.

### Added

- **Promotion gate module** (`core/connectors/candidate_gate.py`) — 9 gate checks
- **Single candidate eligibility** — `check_promotion_eligibility()` returns `PromotionGateResult`
- **Batch eligibility** — `check_all_promotion_eligibility()` for all candidates
- **9 gate checks**: candidate_exists, has_accepted_decision, has_reviewer, has_rationale, has_evidence_ids, has_provenance, has_title, has_category, has_description
- **Blocking reasons** — each failed check provides a specific reason
- **Formatted reports** — `format_eligibility_report()` and `format_batch_eligibility_report()`
- **Status reader** — shows gate-ready count for accepted candidates
- **28 new tests** covering all checks, batch, formatting, no-mutation

### Gate Checks

| Check | Requirement |
|---|---|
| candidate_exists | Candidate found in candidate-findings.json |
| has_accepted_decision | Review decision is 'accepted' |
| has_reviewer | Reviewer field is non-empty |
| has_rationale | Rationale field is non-empty |
| has_evidence_ids | At least one evidence ID attached |
| has_provenance | Provenance metadata present |
| has_title | Title is non-empty |
| has_category | Category is non-empty |
| has_description | Description is non-empty |

### Design Rules

- Gate is read-only — no mutation of any artifact
- No writing to debt-register.json
- No creating accepted DebtFinding
- No work package generation
- No ticket creation

## [3.8.0] - Unreleased

### Candidate Decision Reporting and Audit Trail
Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,7 @@ Pharabius is a mature CLI engine with an early-stage platform. Current limitatio
- _v3.6.0 adds **evidence-to-finding candidate promotion**: external evidence can propose reviewable candidate findings. Candidates are not accepted findings._
- _v3.7.0 adds **candidate review workflow**: governed review of candidates with explicit decisions. Acceptance is review-level only, not debt-register promotion._
- _v3.8.0 adds **candidate decision reporting**: audit trail, review summary in reports and governance export. Read-only — no mutation._
- _v3.9.0 adds **candidate promotion gate**: eligibility rules for promotion without performing it. Gate-only — no writing to debt-register._
- **No live ticket sync** — No Jira, Linear, or GitHub Issues integration
- **Platform frontend is prototype-grade** — 28 tests pass, build succeeds, but 5 pre-existing TypeScript errors in test mocks
- **No portfolio governance** — Multi-repo governance workflows not implemented
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "pharabius"
version = "3.8.0"
version = "3.9.0"
description = "Repository-first technical debt intelligence platform"
readme = "README.md"
requires-python = ">=3.11"
Expand Down
Loading
Loading