Skip to content

feat(governance): in-runtime policy evaluator + native exports#124

Open
aditik0303 wants to merge 4 commits into
feat/governance-guardrail-compensationfrom
feat/governance-evaluator
Open

feat(governance): in-runtime policy evaluator + native exports#124
aditik0303 wants to merge 4 commits into
feat/governance-guardrail-compensationfrom
feat/governance-evaluator

Conversation

@aditik0303

Copy link
Copy Markdown

Stacked PR 5/7 — part of splitting feat/governance-core into reviewable slices. Base: feat/governance-guardrail-compensation. One logical slice (branch is cumulative so CI is green). Merge in order #1#7 and delete each branch on merge so the next PR auto-retargets onto feat/agentic-governance. feat/governance-core kept untouched as backup.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces a native (in-process) governance policy evaluator implementation and adds a comprehensive test suite validating enforcement modes, operator behavior, and key governance detectors (including incident taxonomy and commitment language detection). It also exposes the native evaluator and models via uipath.runtime.governance.native for downstream consumption.

Changes:

  • Add GovernanceEvaluator implementation with operator support, audit emission, and guardrail-compensation dispatching.
  • Add new tests covering evaluator enforcement/audit behavior, operator semantics, and commitment-language/incident detection.
  • Export native evaluator and policy-model symbols from uipath.runtime.governance.native.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
tests/test_text_extraction.py Adds tests for governable-text extraction used by the governance wrapper.
tests/test_evaluator.py Adds tests for evaluator enforcement modes and audit/exception behavior.
tests/test_evaluator_operators.py Adds tests for operator semantics, field resolution, and evaluate_* dispatcher context building.
tests/test_commitment_concern.py Adds tests for updated commitment-language detection behavior.
src/uipath/runtime/governance/native/evaluator.py Adds the native governance evaluator implementation and detector/operator logic.
src/uipath/runtime/governance/native/init.py Exposes the evaluator + native policy model + loader APIs via package exports.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread tests/test_text_extraction.py Outdated
Comment thread src/uipath/runtime/governance/native/evaluator.py
Comment thread src/uipath/runtime/governance/native/evaluator.py
Comment thread src/uipath/runtime/governance/native/evaluator.py Outdated
Comment thread src/uipath/runtime/governance/native/evaluator.py Outdated
@aditik0303 aditik0303 force-pushed the feat/governance-guardrail-compensation branch from 8812695 to 2da1f67 Compare June 16, 2026 09:30
@aditik0303 aditik0303 force-pushed the feat/governance-evaluator branch from a019ade to 6af3c9f Compare June 16, 2026 11:03
@aditik0303 aditik0303 force-pushed the feat/governance-guardrail-compensation branch from 2da1f67 to 5b119ac Compare June 17, 2026 06:37
@aditik0303 aditik0303 force-pushed the feat/governance-evaluator branch from 6af3c9f to f7cc79e Compare June 17, 2026 06:52
@aditik0303 aditik0303 force-pushed the feat/governance-guardrail-compensation branch from 5b119ac to 2154aba Compare June 17, 2026 08:35
@aditik0303 aditik0303 force-pushed the feat/governance-evaluator branch from f7cc79e to 94cea5b Compare June 17, 2026 08:35
@aditik0303 aditik0303 force-pushed the feat/governance-guardrail-compensation branch from 2154aba to 1f7bdad Compare June 19, 2026 08:08
@aditik0303 aditik0303 force-pushed the feat/governance-evaluator branch 2 times, most recently from ce18588 to e186f5f Compare June 19, 2026 11:25
@viswa-uipath viswa-uipath force-pushed the feat/governance-guardrail-compensation branch 2 times, most recently from 0e9ad5b to 470533e Compare June 24, 2026 10:57
aditik0303 and others added 4 commits June 24, 2026 17:31
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… in rule + cross-rule aggregation; align vader threshold default to -0.3 (matches docstring/comment/else + YAML default); importorskip wrapper in text-extraction test

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… import

- evaluator.py: inline `# type: ignore[import-untyped]` on the vaderSentiment
  import (replaces the removed [[tool.mypy.overrides]] entry; vaderSentiment
  ships no stubs).
- test_evaluator / test_evaluator_operators: import reset helper from tests._helpers.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…orts

Closes radu's recurring boundary objection for the evaluator slice and
makes the post-rebase stack actually import. The evaluator was the
last place where everything PR #121-#123 instance-scoped collapsed
back to process globals.

Architectural
- GovernanceEvaluator gains constructor injection:
  GovernanceEvaluator(policy_index, *, enforcement_mode=AUDIT,
                      audit_manager=None, compensator=None)
- Drop get_audit_manager() / get_enforcement_mode() / submit_compensation
  free-function lookups. The evaluator now consults zero process-globals
  on the hot path.
- mode property is read-only (drop the setter); no two-writer race
  between the loader and evaluator.
- audit_manager=None and compensator=None short-circuit cleanly so
  tests + minimal wirings work without injecting every dep.
- Drop unused is_enforce_mode() public method (dead code; no caller in
  src/ or tests/).

Post-rebase plumbing
- _dispatch_compensation uses self._compensator.submit(...) instead of
  the deleted free function; reads r.validator (Pydantic attribute)
  instead of the old r["validator"] TypedDict access.
- _emit_audit passes policy_id (PR #122 trace-contract field, was
  rule_id) and enforcement_mode=mode enum (PR #122 required arg).
- Import EnforcementMode from uipath.core.governance (governance.config
  deleted in PR #121); import AuditManager from _audit.base (audit/ is
  _audit/ post-PR-#122).

native/__init__.py
- Drop the four module-level loader-function re-exports
  (get_policy_index / load_policy_index / prefetch_policy_index /
  reset_policy_index) — all deleted in PR #121's PolicyLoader refactor.
- Export PolicyLoader instead.

Tests
- test_evaluator: full rewrite. Drop deleted-import paths
  (tests._helpers.reset_enforcement_mode, governance.config). Replace
  the global-manager fixture with a per-test AuditManager that uses
  register_default_sinks=False + a capturing sink. Every
  GovernanceEvaluator() call routes through a _build_evaluator helper
  with explicit mode + manager. New test_no_audit_manager_short_circuits
  replaces the previous test that mocked the global to raise.
- test_evaluator_operators: drop the autouse mode-isolating fixture
  (no globals to isolate); DISABLED-mode test passes
  enforcement_mode=EnforcementMode.DISABLED via constructor.
- test_guardrail_compensation: rebase-conflict resolution dropped the
  stale incoming-side imports (Action/LifecycleHook, backend_client,
  unguarded GovernanceEvaluator) since none of them are referenced in
  the rest of the file.

357 passed, 1 skipped (pre-existing wrapper skip). Ruff clean. Mypy
clean (11 source files). Bandit shows only the pre-existing B101 in
_yaml_to_index.py (out of scope).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@viswa-uipath viswa-uipath force-pushed the feat/governance-evaluator branch from e186f5f to 5812bbf Compare June 24, 2026 12:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants