[FEAT]: Add explicit response evaluation scopes

[Spencer Schoenberg (spencrr)]

Description

Adds ResponseScope.ANY_TURN, ALL_TURNS, and CURRENT_TURN to ResponseContains. Omitting scope preserves current-response behavior and emits a FutureWarning for multi-turn contexts, prompting callers to make the intended quantifier explicit.

The documentation includes one source-of-truth table for positive and negated attack/probe forms, explains how each built-in evaluator sees the transcript, and clarifies that scope applies to turns already present in EvalContext rather than controlling execution length or stopping.

Breaking changes

None. The API is additive and omitted scope retains existing behavior. Multi-turn calls without an explicit scope now emit a FutureWarning.

Checklist

• pre-commit run --all-files passes
• Tests added for all response scopes, warnings, empty contexts, and negation
• Documentation updated

Validation: 31 focused evaluator tests pass. Lint, formatting, type checks, and strict documentation build pass.

[azure-pipelines]

Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

Pull request overview

Adds explicit temporal scopes to ResponseContains while preserving current-turn defaults with migration warnings.

Changes:

• Introduces ANY_TURN, ALL_TURNS, and CURRENT_TURN.
• Adds scope, warning, negation, and edge-case tests.
• Documents migration semantics across APIs, probes, attacks, and custom evaluators.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
rampart/evaluators/response_contains.py	Implements response scopes and warnings.
rampart/evaluators/__init__.py	Exports ResponseScope.
tests/unit/evaluators/test_response_contains.py	Tests scoped evaluation behavior.
docs/usage/authoring-tests.md	Documents scope selection and migration.
docs/probes/behavioral.md	Updates multi-turn probe guidance.
docs/contributing/extending-rampart.md	Updates custom evaluator guidance.
docs/attacks/xpia.md	Adds explicit attack evaluator scopes.
docs/api/index.md	Lists the new enum.
docs/api/evaluators.md	Adds API reference generation.

[Nina Chikanov (nina-msft)]

These comments are GHCP flagged & some of them I've tweaked wording slightly. Leaving these here for full coverage :-)