@usearazzo/runner 1.0.1-alpha.19 → 1.0.1-alpha.20

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.0.1-alpha.20](https://github.com/usearazzo/arazzo-toolkit/compare/v1.0.1-alpha.19...v1.0.1-alpha.20) (2026-11-01)
+
+### Bug Fixes
+
+- **runner:** fail a criterion that cannot be evaluated ([#301](https://github.com/usearazzo/arazzo-toolkit/issues/301)) ([efd7de6](https://github.com/usearazzo/arazzo-toolkit/commit/efd7de612de65bce741e88353c5f7a7cca5279de)), closes [#231](https://github.com/usearazzo/arazzo-toolkit/issues/231) [#120](https://github.com/usearazzo/arazzo-toolkit/issues/120) [#231](https://github.com/usearazzo/arazzo-toolkit/issues/231)
+
+### BREAKING CHANGES
+
+- **runner:** XPathCriterionEvaluator reports a non-XML context with
+  reason invalid-xpath-context instead of invalid-context, and
+  CriterionError.reason is typed as CriterionErrorReason instead of string.
+
 ## [1.0.1-alpha.19](https://github.com/usearazzo/arazzo-toolkit/compare/v1.0.1-alpha.18...v1.0.1-alpha.19) (2026-10-31)
 
 ### Bug Fixes

package/README.md

@@ -44,7 +44,7 @@ A runner is four building blocks, composed bottom-up; `ArazzoRunner` composes th
   <img alt="Runner architecture: WorkflowExecutor runs steps through StepExecutor, which runs OpenAPI operations through OpenAPIOperationExecutor and the HTTPClient; DocumentRegistry supplies documents to all three executors" src="https://raw.githubusercontent.com/usearazzo/arazzo-toolkit/main/packages/runner/assets/architecture.svg">
 </p>
 
-A step whose criteria go unmet is a result, not an error: the run resolves with `status: 'failed'`. Only a document that cannot be loaded or run as written, a request that cannot be built or sent, or a cancelled run throws, and every such error extends `ArazzoRunnerError`; a document that cannot be read or loaded (a missing file, an HTTP error, an unresolvable reference) throws `DocumentLoadError` with the underlying failure as its `cause`.
+A step whose criteria go unmet is a result, not an error: the run resolves with `status: 'failed'`. A criterion whose condition cannot be evaluated (an invalid regex, JSONPath, XPath or simple condition, or non-XML data under an `xpath` query) counts as unmet, as Arazzo 1.1.0 requires, rather than throwing. The type-specific criterion evaluators raise such a condition as `CriterionEvaluationError`, a `CriterionError` subclass, and every `CriterionError` carries a `reason` from `CriterionErrorReason`. Only a document that cannot be loaded or run as written, a request that cannot be built or sent, or a cancelled run throws, and every such error extends `ArazzoRunnerError`; a document that cannot be read or loaded (a missing file, an HTTP error, an unresolvable reference) throws `DocumentLoadError` with the underlying failure as its `cause`.
 
 ## Installation