Governance

Excusez-nous — cette page est actuellement disponible en anglais uniquement.

La traduction française n'est pas encore prête. Le contenu ci-dessous est la version anglaise la plus récente.

?? Early access — incomplete, not fully tested. The Governance panel exists in the Control Center but the UI and underlying data pipeline are not complete. Some sections may be empty, inaccurate, or missing. Do not rely on it for compliance decisions in its current state.

What Governance is

Governance is an audit trail and policy-check layer built into BranchPy. As you run analysis, Pilot, media validation, and other commands, the tool emits structured governance events � timestamped records that capture what ran, when, what changed, and whether any policy rules were triggered. The Governance panel in the Control Center surfaces those events so you can review them without leaving the editor.

The intended use cases are:

  • Audit trail � see a chronological log of all significant tool actions (analysis runs, errors detected, media checks, AI usage, telemetry flushes) with timestamps and correlation IDs.
  • Policy checks � verify that your project passes configured quality rules (e.g. unreachable routes, missing media, coverage thresholds).
  • Evidence exports � download a JSON or HTML summary of governance events for external review (e.g. RC sign-off, compliance handoff).

Current state (v1.1.1)

The governance event emission infrastructure is in place � events are written to .branchpy/logs/telemetry/ by analysis, media validation, and telemetry sync. The viewer UI and the REST API that feeds it are still in development. Specifically:

  • The Governance panel may show empty or placeholder data.
  • Event filtering, replay, and diff views are implemented at the API level but not fully wired to the UI.
  • Evidence export is not yet available from the UI.

If you need the raw event log now, look in .branchpy/logs/telemetry/ in your project directory.

Learn more: Technical/governance