solverforge 0.6.5__tar.gz → 0.6.7__tar.gz

{solverforge-0.6.5 → solverforge-0.6.7}/Cargo.lock

@@ -560,9 +560,9 @@ checksum = "8ed6a63f02c8539c91a8685a86f4099661ba3da017932f6ebbea6de3f0fa7c90"
 
 [[package]]
 name = "solverforge-bridge"
-version = "0.19.3"
+version = "0.19.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c78f964f79318c3c0ee3161ed3004c708f04c4a751f784fe7d0ccc908194aaa3"
+checksum = "6257a13961202890dad23729ccceae45afd14c156e046c60b74e739bf0a26f36"
 dependencies = [
  "solverforge-config",
  "solverforge-core",
@@ -572,9 +572,9 @@ dependencies = [
 
 [[package]]
 name = "solverforge-config"
-version = "0.19.3"
+version = "0.19.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "27d4cb13eb5097514c5d18eeddb0f88521e3f3d8d402a0d22ffbbdcd08c90c21"
+checksum = "0801115100979d1c4558918277d6a2f2992f843f90f67b9fc0cf78699a5bde06"
 dependencies = [
  "serde",
  "serde_yaml",
@@ -585,9 +585,9 @@ dependencies = [
 
 [[package]]
 name = "solverforge-console"
-version = "0.19.3"
+version = "0.19.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3f64e369266512f53d2bd335592975193fdc4d8c2d6da99929f152edfd721562"
+checksum = "2728833bbaf987be4058e60d77a013408b8c577570a552adecddd0461ac56f40"
 dependencies = [
  "num-format",
  "owo-colors",
@@ -597,18 +597,18 @@ dependencies = [
 
 [[package]]
 name = "solverforge-core"
-version = "0.19.3"
+version = "0.19.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e6118e7d98c3c8ef58646b2779603dd1ab6f9dc9f25481cb104402cbcd06be46"
+checksum = "897a977c2b4af1ceb8bb01707bd23783ffa1363d7c70950767718b3daf767e48"
 dependencies = [
  "thiserror",
 ]
 
 [[package]]
 name = "solverforge-scoring"
-version = "0.19.3"
+version = "0.19.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3ddf9f9af52b0d2525f581f921e41fac8352dc2f6f1deb7f9100aff9cfedba25"
+checksum = "18f932ada3a948f09e3234197dc4696626264c73e89f2cf520fe3e87ad61f445"
 dependencies = [
  "solverforge-core",
  "thiserror",
@@ -616,9 +616,9 @@ dependencies = [
 
 [[package]]
 name = "solverforge-solver"
-version = "0.19.3"
+version = "0.19.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "19d30aece798a48d08edc630734a181dd2d9bcc1e806de7ec27701f9885989a6"
+checksum = "e2f21595deb21733528ffbb95c076dceee638aa93bafad812676aa53ca7af4b1"
 dependencies = [
  "rand",
  "rand_chacha",
@@ -635,16 +635,16 @@ dependencies = [
 
 [[package]]
 name = "solverforge-ui"
-version = "0.7.0"
+version = "0.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4f28bc3b68bf72c2ed690c9e6f67627aad2e17f0b239da90125bb229ecbf4362"
+checksum = "87dc89ca92af46ff7c55eb29d4072d98b2414047fd84cd8c77458e60468d53f6"
 dependencies = [
  "include_dir",
 ]
 
 [[package]]
 name = "solverforge_py"
-version = "0.6.5"
+version = "0.6.7"
 dependencies = [
  "indexmap",
  "once_cell",

{solverforge-0.6.5 → solverforge-0.6.7}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "solverforge_py"
-version = "0.6.5"
+version = "0.6.7"
 edition = "2021"
 license = "Apache-2.0"
 rust-version = "1.95"
@@ -26,7 +26,7 @@ name = "solverforge_py"
 crate-type = ["cdylib", "rlib"]
 
 [package.metadata.solverforge]
-version = "0.19.3"
+version = "0.19.7"
 
 [dependencies]
 indexmap = "2.12.1"
@@ -42,13 +42,13 @@ toml = "0.9.8"
 tracing = "0.1.44"
 tracing-subscriber = { version = "0.3.23", features = ["env-filter"] }
 
-solverforge-config = { version = "=0.19.3" }
-solverforge-bridge = { version = "=0.19.3" }
-solverforge-console = { version = "=0.19.3", features = ["verbose-logging"] }
-solverforge-core = { version = "=0.19.3" }
-solverforge-scoring = { version = "=0.19.3" }
-solverforge-solver = { version = "=0.19.3" }
-solverforge-ui = { version = "=0.7.0", default-features = false }
+solverforge-config = { version = "=0.19.7" }
+solverforge-bridge = { version = "=0.19.7" }
+solverforge-console = { version = "=0.19.7", features = ["verbose-logging"] }
+solverforge-core = { version = "=0.19.7" }
+solverforge-scoring = { version = "=0.19.7" }
+solverforge-solver = { version = "=0.19.7" }
+solverforge-ui = { version = "=0.9.0", default-features = false }
 
 [dev-dependencies]
 pretty_assertions = "1.4.1"

{solverforge-0.6.5 → solverforge-0.6.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solverforge
-Version: 0.6.5
+Version: 0.6.7
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
@@ -39,23 +39,24 @@ The native extension owns the working solution state in Rust so SolverForge can
 clone, mutate, and snapshot solutions safely. Python callbacks are the single
 constraint authoring surface.
 
-The package targets CPython 3.14 and Rust 1.95.0. This checkout targets the
-SolverForge Rust crates `0.19.3` and pins `solverforge-ui` to `0.7.0` through
-exact crates.io versions in `Cargo.toml` and registry checksums in `Cargo.lock`.
-There is no local path or Git dependency override. The `solverforge`
-`0.6.x` line is the current dynamic binding architecture and intentionally
-supersedes the older incompatible `0.2.x` and `0.3.0` artifacts in the same PyPI
-namespace. Those older artifacts exposed `SolverFactory`, `PlanningVariable`,
-Java service requirements, and other APIs that are not part of this package.
+The package targets CPython 3.14 and Rust 1.95.0. This release-preparation
+checkout pins the six published SolverForge Rust dependencies to `0.19.7` and
+`solverforge-ui` to `0.9.0` through exact crates.io requirements in
+`Cargo.toml` and registry checksums in `Cargo.lock`. There is no local path or
+Git dependency override. The `solverforge` `0.6.x` line is the current dynamic
+binding architecture and intentionally supersedes the older incompatible
+`0.2.x` and `0.3.0` artifacts in the same PyPI namespace.
+Those older artifacts exposed `SolverFactory`, `PlanningVariable`, Java service
+requirements, and other APIs that are not part of this package.
 
 ## Installation
 
-The package version prepared by this checkout is `solverforge` `0.6.5`, targeting
-the published and locked SolverForge Rust `0.19.3` registry dependency base.
+The package version prepared by this checkout is `solverforge` `0.6.7`, targeting
+the published and registry-locked SolverForge Rust `0.19.7` dependency base.
 Install the matching package after its Python release with:
 
 ```sh
-python3.14 -m pip install "solverforge==0.6.5"
+python3.14 -m pip install "solverforge==0.6.7"
 ```
 
 The installable wheel contains the core `solverforge` package, native extension,
@@ -74,13 +75,13 @@ make hospital-run
 make deliveries-run PORT=7861
 ```
 
-After publication, the same source-checkout examples can be run against the
-installed package without `PYTHONPATH` or an editable checkout:
+The same source-checkout examples can be run against the matching published
+package once `0.6.7` is released, without `PYTHONPATH` or an editable checkout:
 
 ```sh
 python3.14 -m venv .venv-examples
 . .venv-examples/bin/activate
-python -m pip install "solverforge[examples]==0.6.5"
+python -m pip install "solverforge[examples]==0.6.7"
 python examples/nqueens.py
 python -m examples.solverforge_hospital
 python -m examples.solverforge_deliveries
@@ -240,8 +241,13 @@ Run `make help` for focused targets such as `make test-hospital`,
   either a Python callback or a row field name. Dual raw-schema sources are
   rejected at compilation, while immutable row metadata can be supplied without
   per-query Python callbacks. Provider-backed value ranges are imported once per
-  variable and shared across rows in Rust-owned state; row candidate callbacks
-  remain row-specific.
+  variable and shared across rows in Rust-owned state. Row candidate callbacks
+  remain row-specific and define move legality throughout construction and local
+  search, including assignment-group swaps and rematches. `pinning=True` is
+  rejected with `ModelValidationError` rather than ignored: SolverForge pins a
+  whole planning entity through an entity-level descriptor predicate, and no
+  public bridge seam exposes entity pinning to the Python binding yet. Pin an
+  input value by restricting `candidate_values` instead.
 - `scalar_assignment_group(...)` declares assignment-aware scalar groups for
   grouped scalar local search and assignment-group construction. Group metadata
   covers required entities, capacity keys, assignment rules, ordering callbacks,
@@ -252,9 +258,12 @@ Run `make help` for focused targets such as `make test-hospital`,
   metadata, `required_entity_field`, `capacity_key_field`,
   `position_key_field`, and `sequence_key_field` are explicit alternatives to
   their callbacks: required is a row bool, position and sequence are row
-  integers, and capacity is a row list indexed by candidate value. A field
-  alternative is mutually exclusive with its callback and avoids
-  per-candidate Python transitions without caching or changing callback behavior.
+  integers, and capacity is a row list indexed by candidate value.
+  `same_value_conflict_field` is the native alternative for a static
+  `assignment_rule`: each row lists adjacent-sequence entity indexes that
+  cannot hold the same assigned value, and the group still requires sequence
+  metadata. Field alternatives avoid per-candidate Python transitions without
+  caching or changing callback behavior.
   The compiled schema retains one immutable runtime plan (schema, descriptor,
   and model), reused by direct solves, manager jobs, snapshots, and resumes;
   instance rows, callback views, seeds, and moves remain per solve.

{solverforge-0.6.5 → solverforge-0.6.7}/README.md

@@ -8,23 +8,24 @@ The native extension owns the working solution state in Rust so SolverForge can
 clone, mutate, and snapshot solutions safely. Python callbacks are the single
 constraint authoring surface.
 
-The package targets CPython 3.14 and Rust 1.95.0. This checkout targets the
-SolverForge Rust crates `0.19.3` and pins `solverforge-ui` to `0.7.0` through
-exact crates.io versions in `Cargo.toml` and registry checksums in `Cargo.lock`.
-There is no local path or Git dependency override. The `solverforge`
-`0.6.x` line is the current dynamic binding architecture and intentionally
-supersedes the older incompatible `0.2.x` and `0.3.0` artifacts in the same PyPI
-namespace. Those older artifacts exposed `SolverFactory`, `PlanningVariable`,
-Java service requirements, and other APIs that are not part of this package.
+The package targets CPython 3.14 and Rust 1.95.0. This release-preparation
+checkout pins the six published SolverForge Rust dependencies to `0.19.7` and
+`solverforge-ui` to `0.9.0` through exact crates.io requirements in
+`Cargo.toml` and registry checksums in `Cargo.lock`. There is no local path or
+Git dependency override. The `solverforge` `0.6.x` line is the current dynamic
+binding architecture and intentionally supersedes the older incompatible
+`0.2.x` and `0.3.0` artifacts in the same PyPI namespace.
+Those older artifacts exposed `SolverFactory`, `PlanningVariable`, Java service
+requirements, and other APIs that are not part of this package.
 
 ## Installation
 
-The package version prepared by this checkout is `solverforge` `0.6.5`, targeting
-the published and locked SolverForge Rust `0.19.3` registry dependency base.
+The package version prepared by this checkout is `solverforge` `0.6.7`, targeting
+the published and registry-locked SolverForge Rust `0.19.7` dependency base.
 Install the matching package after its Python release with:
 
 ```sh
-python3.14 -m pip install "solverforge==0.6.5"
+python3.14 -m pip install "solverforge==0.6.7"
 ```
 
 The installable wheel contains the core `solverforge` package, native extension,
@@ -43,13 +44,13 @@ make hospital-run
 make deliveries-run PORT=7861
 ```
 
-After publication, the same source-checkout examples can be run against the
-installed package without `PYTHONPATH` or an editable checkout:
+The same source-checkout examples can be run against the matching published
+package once `0.6.7` is released, without `PYTHONPATH` or an editable checkout:
 
 ```sh
 python3.14 -m venv .venv-examples
 . .venv-examples/bin/activate
-python -m pip install "solverforge[examples]==0.6.5"
+python -m pip install "solverforge[examples]==0.6.7"
 python examples/nqueens.py
 python -m examples.solverforge_hospital
 python -m examples.solverforge_deliveries
@@ -209,8 +210,13 @@ Run `make help` for focused targets such as `make test-hospital`,
   either a Python callback or a row field name. Dual raw-schema sources are
   rejected at compilation, while immutable row metadata can be supplied without
   per-query Python callbacks. Provider-backed value ranges are imported once per
-  variable and shared across rows in Rust-owned state; row candidate callbacks
-  remain row-specific.
+  variable and shared across rows in Rust-owned state. Row candidate callbacks
+  remain row-specific and define move legality throughout construction and local
+  search, including assignment-group swaps and rematches. `pinning=True` is
+  rejected with `ModelValidationError` rather than ignored: SolverForge pins a
+  whole planning entity through an entity-level descriptor predicate, and no
+  public bridge seam exposes entity pinning to the Python binding yet. Pin an
+  input value by restricting `candidate_values` instead.
 - `scalar_assignment_group(...)` declares assignment-aware scalar groups for
   grouped scalar local search and assignment-group construction. Group metadata
   covers required entities, capacity keys, assignment rules, ordering callbacks,
@@ -221,9 +227,12 @@ Run `make help` for focused targets such as `make test-hospital`,
   metadata, `required_entity_field`, `capacity_key_field`,
   `position_key_field`, and `sequence_key_field` are explicit alternatives to
   their callbacks: required is a row bool, position and sequence are row
-  integers, and capacity is a row list indexed by candidate value. A field
-  alternative is mutually exclusive with its callback and avoids
-  per-candidate Python transitions without caching or changing callback behavior.
+  integers, and capacity is a row list indexed by candidate value.
+  `same_value_conflict_field` is the native alternative for a static
+  `assignment_rule`: each row lists adjacent-sequence entity indexes that
+  cannot hold the same assigned value, and the group still requires sequence
+  metadata. Field alternatives avoid per-candidate Python transitions without
+  caching or changing callback behavior.
   The compiled schema retains one immutable runtime plan (schema, descriptor,
   and model), reused by direct solves, manager jobs, snapshots, and resumes;
   instance rows, callback views, seeds, and moves remain per solve.

{solverforge-0.6.5 → solverforge-0.6.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "solverforge"
-version = "0.6.5"
+version = "0.6.7"
 description = "Dynamic Python bindings for the SolverForge constraint solver."
 readme = "README.md"
 license = { text = "Apache-2.0" }

{solverforge-0.6.5 → solverforge-0.6.7}/python/solverforge/__init__.py

@@ -40,7 +40,7 @@ from .manager import JobHandle, SolverManager
 from .score import HardMediumSoftScore, HardSoftDecimalScore, HardSoftScore, SoftScore
 from .solver import Solver
 
-__version__ = "0.6.5"
+__version__ = "0.6.7"
 
 __all__ = [
     "CallbackError",

{solverforge-0.6.5 → solverforge-0.6.7}/python/solverforge/decorators.py

@@ -40,7 +40,6 @@ def _collect_fields(cls: type[object]) -> list[dict[str, object]]:
                     "nearby_entity_distance_field": value.metadata.nearby_entity_distance_field,
                     "allows_unassigned": value.metadata.allows_unassigned,
                     "element_collection": value.metadata.element_collection,
-                    "pinning": value.metadata.pinning,
                     "element_owner": value.metadata.element_owner,
                     "element_owner_field": value.metadata.element_owner_field,
                     "construction_element_order_key": value.metadata.construction_element_order_key,

{solverforge-0.6.5 → solverforge-0.6.7}/python/solverforge/fields.py

@@ -5,6 +5,8 @@ from dataclasses import dataclass
 from inspect import Parameter, signature
 from typing import Any, NamedTuple, TypeAlias
 
+from .errors import ModelValidationError
+
 MetadataSource = Callable[..., object] | str
 
 
@@ -143,7 +145,6 @@ class FieldMetadata:
     nearby_entity_distance_field: str | None = None
     allows_unassigned: bool = False
     element_collection: str | None = None
-    pinning: bool = False
     element_owner: Callable[..., object] | None = None
     element_owner_field: str | None = None
     construction_element_order_key: Callable[..., object] | None = None
@@ -191,6 +192,14 @@ def planning_variable(
     allows_unassigned: bool = False,
     pinning: bool = False,
 ) -> PlanningField:
+    if pinning:
+        msg = (
+            "planning_variable(pinning=True) is not supported: SolverForge pins a whole "
+            "planning entity through an entity-level descriptor predicate, and no public "
+            "bridge seam exposes entity pinning to the Python binding yet. Pin an input "
+            "value by restricting candidate_values instead."
+        )
+        raise ModelValidationError(msg)
     value_candidates = _resolve_metadata_source(
         nearby_value_candidates, name="nearby_value_candidates"
     )
@@ -217,7 +226,6 @@ def planning_variable(
             nearby_entity_distance_meter=entity_distance.callback,
             nearby_entity_distance_field=entity_distance.field_name,
             allows_unassigned=allows_unassigned,
-            pinning=pinning,
         )
     )
 

{solverforge-0.6.5 → solverforge-0.6.7}/python/solverforge/groups.py

@@ -51,6 +51,7 @@ class ScalarAssignmentGroup:
     capacity_key: Callable[..., object] | None = None
     capacity_key_field: str | None = None
     assignment_rule: Callable[..., object] | None = None
+    same_value_conflict_field: str | None = None
     position_key: Callable[..., object] | None = None
     position_key_field: str | None = None
     sequence_key: Callable[..., object] | None = None
@@ -95,6 +96,20 @@ class ScalarAssignmentGroup:
                 raise TypeError(
                     f"{field_name} must be a non-empty string when provided"
                 )
+        if (
+            self.assignment_rule is not None
+            and self.same_value_conflict_field is not None
+        ):
+            raise TypeError(
+                "assignment_rule and same_value_conflict_field cannot both be configured"
+            )
+        if self.same_value_conflict_field is not None and (
+            not isinstance(self.same_value_conflict_field, str)
+            or not self.same_value_conflict_field
+        ):
+            raise TypeError(
+                "same_value_conflict_field must be a non-empty string when provided"
+            )
 
     def to_native(self) -> dict[str, Any]:
         return {
@@ -107,6 +122,7 @@ class ScalarAssignmentGroup:
             "capacity_key": self.capacity_key,
             "capacity_key_field": self.capacity_key_field,
             "assignment_rule": self.assignment_rule,
+            "same_value_conflict_field": self.same_value_conflict_field,
             "position_key": self.position_key,
             "position_key_field": self.position_key_field,
             "sequence_key": self.sequence_key,
@@ -128,6 +144,7 @@ def scalar_assignment_group(
     capacity_key: Callable[..., object] | None = None,
     capacity_key_field: str | None = None,
     assignment_rule: Callable[..., object] | None = None,
+    same_value_conflict_field: str | None = None,
     position_key: Callable[..., object] | None = None,
     position_key_field: str | None = None,
     sequence_key: Callable[..., object] | None = None,
@@ -145,6 +162,9 @@ def scalar_assignment_group(
     callback transitions while preserving the declared metadata values. The declaration compiles
     into one immutable native runtime plan rather than a Python-side assignment search path. Its
     target variable is exclusively searched through the resulting grouped selector.
+    ``same_value_conflict_field`` names a row list of adjacent-sequence entity indices that may
+    not share the same assigned value, providing a native conflict-graph alternative to
+    ``assignment_rule``.
     """
 
     return ScalarAssignmentGroup(
@@ -156,6 +176,7 @@ def scalar_assignment_group(
         capacity_key=capacity_key,
         capacity_key_field=capacity_key_field,
         assignment_rule=assignment_rule,
+        same_value_conflict_field=same_value_conflict_field,
         position_key=position_key,
         position_key_field=position_key_field,
         sequence_key=sequence_key,

{solverforge-0.6.5 → solverforge-0.6.7}/python/solverforge/model.py

@@ -222,6 +222,16 @@ def _scalar_groups(callbacks: object) -> list[dict[str, object]]:
                     "assignment-rule groups need sequence metadata"
                 )
                 raise ModelValidationError(msg)
+            if (
+                item.same_value_conflict_field is not None
+                and item.sequence_key is None
+                and item.sequence_key_field is None
+            ):
+                msg = (
+                    f"{item!r} declares a same_value_conflict_field but no sequence_key; "
+                    "same-value conflict groups need sequence metadata"
+                )
+                raise ModelValidationError(msg)
             if item.name in names:
                 msg = f"scalar group name `{item.name}` is declared more than once"
                 raise ModelValidationError(msg)

{solverforge-0.6.5 → solverforge-0.6.7}/src/runtime/dynamic_assignment_group.rs

@@ -100,6 +100,18 @@ fn build_assignment_group(
             group.name
         ));
     }
+    if group.assignment_rule.is_some() && group.same_value_conflict_field.is_some() {
+        return Err(format!(
+            "assignment scalar group `{}` cannot declare both assignment_rule and same_value_conflict_field",
+            group.name
+        ));
+    }
+    if group.same_value_conflict_field.is_some() && group.sequence_key.is_none() {
+        return Err(format!(
+            "assignment scalar group `{}` declares same_value_conflict_field but no sequence_key",
+            group.name
+        ));
+    }
 
     let slot = DynamicScalarVariableSlot::new(
         EntityClassId(entity_index),
@@ -368,6 +380,14 @@ impl PyDynamicAssignmentMetadata {
         right_entity: usize,
         right_value: usize,
     ) -> bool {
+        if let Some(field_name) = self.group().same_value_conflict_field.as_deref() {
+            if left_value != right_value {
+                return true;
+            }
+            return !self
+                .same_value_conflicts(solution, field_name, left_entity, right_entity)
+                .unwrap_or_else(panic_with_py_err);
+        }
         self.callback_value(
             solution,
             "assignment_rule",
@@ -377,6 +397,63 @@ impl PyDynamicAssignmentMetadata {
         .unwrap_or_else(panic_with_py_err)
         .unwrap_or(true)
     }
+
+    fn same_value_conflicts(
+        &self,
+        solution: &PyDynamicSolution,
+        field_name: &str,
+        left_entity: usize,
+        right_entity: usize,
+    ) -> PyResult<bool> {
+        Ok(
+            self.row_conflicts_with(solution, field_name, left_entity, right_entity)?
+                || self.row_conflicts_with(solution, field_name, right_entity, left_entity)?,
+        )
+    }
+
+    fn row_conflicts_with(
+        &self,
+        solution: &PyDynamicSolution,
+        field_name: &str,
+        entity_index: usize,
+        other_entity_index: usize,
+    ) -> PyResult<bool> {
+        let value = solution
+            .state
+            .entities
+            .get(self.entity_index)
+            .and_then(|rows| rows.get(entity_index))
+            .and_then(|row| row.fields.get(field_name))
+            .ok_or_else(|| {
+                py_err(format!(
+                    "assignment scalar group `{}` field `{field_name}` is missing on row {entity_index}",
+                    self.group().name
+                ))
+            })?;
+        let DynamicValue::List(conflicts) = value else {
+            return Err(py_err(format!(
+                "assignment scalar group `{}` same_value_conflict_field `{field_name}` must be a list of entity indices",
+                self.group().name
+            )));
+        };
+        let other_entity_index = i64::try_from(other_entity_index).map_err(|_| {
+            py_err(format!(
+                "assignment entity index `{other_entity_index}` does not fit in a field integer"
+            ))
+        })?;
+        for conflict in conflicts {
+            let DynamicValue::Int(conflict) = conflict else {
+                return Err(py_err(format!(
+                    "assignment scalar group `{}` same_value_conflict_field `{field_name}` must contain only entity indices",
+                    self.group().name
+                )));
+            };
+            if *conflict == other_entity_index {
+                return Ok(true);
+            }
+        }
+        Ok(false)
+    }
 }
 
 impl DynamicScalarAssignmentMetadata<PyDynamicSolution> for PyDynamicAssignmentMetadata {
@@ -389,7 +466,8 @@ impl DynamicScalarAssignmentMetadata<PyDynamicSolution> for PyDynamicAssignmentM
             sequence_key: group.sequence_key.is_some(),
             entity_order: group.entity_order.is_some(),
             value_order: group.value_order.is_some(),
-            assignment_rule: group.assignment_rule.is_some(),
+            assignment_rule: group.assignment_rule.is_some()
+                || group.same_value_conflict_field.is_some(),
         }
     }
 

{solverforge-0.6.5 → solverforge-0.6.7}/src/runtime/scalar_slots.rs

@@ -216,7 +216,13 @@ impl DynamicScalarAccess<PyDynamicSolution> for PyDynamicScalarAccess {
             .unwrap_or(&[])
     }
 
-    fn value_is_legal(&self, solution: &PyDynamicSolution, _row: usize, value: usize) -> bool {
+    fn value_is_legal(&self, solution: &PyDynamicSolution, row: usize, value: usize) -> bool {
+        if let Some(candidates) = self
+            .row(solution, row)
+            .and_then(|row| row.candidates_at(self.variable.0))
+        {
+            return candidates.contains(&value);
+        }
         solution
             .state
             .scalar_value_range_at(self.entity.0, self.variable.0)

{solverforge-0.6.5 → solverforge-0.6.7}/src/schema/parse.rs

@@ -159,6 +159,7 @@ fn parse_assignment_scalar_groups(
             )?,
             capacity_key: optional_metadata_source(group, "capacity_key", "capacity_key_field")?,
             assignment_rule: optional_callable(group, "assignment_rule")?,
+            same_value_conflict_field: optional_str(group, "same_value_conflict_field")?,
             position_key: optional_metadata_source(group, "position_key", "position_key_field")?,
             sequence_key: optional_metadata_source(group, "sequence_key", "sequence_key_field")?,
             entity_order: optional_callable(group, "entity_order")?,

{solverforge-0.6.5 → solverforge-0.6.7}/src/schema/types.rs

@@ -200,6 +200,7 @@ pub struct AssignmentScalarGroupSchema {
     pub required_entity: Option<MetadataSourceSchema>,
     pub capacity_key: Option<MetadataSourceSchema>,
     pub assignment_rule: Option<Py<PyAny>>,
+    pub same_value_conflict_field: Option<String>,
     pub position_key: Option<MetadataSourceSchema>,
     pub sequence_key: Option<MetadataSourceSchema>,
     pub entity_order: Option<Py<PyAny>>,

{solverforge-0.6.5 → solverforge-0.6.7}/src/schema/validate.rs

@@ -58,6 +58,28 @@ pub fn validate_dynamic_schema(schema: &DynamicSchema) -> Result<(), pyo3::PyErr
                 group.name
             )));
         }
+        if group.assignment_rule.is_some() && group.same_value_conflict_field.is_some() {
+            return Err(py_err(format!(
+                "assignment scalar group `{}` cannot declare both assignment_rule and same_value_conflict_field",
+                group.name
+            )));
+        }
+        if group
+            .same_value_conflict_field
+            .as_ref()
+            .is_some_and(String::is_empty)
+        {
+            return Err(py_err(format!(
+                "assignment scalar group `{}` has an empty same_value_conflict_field",
+                group.name
+            )));
+        }
+        if group.same_value_conflict_field.is_some() && group.sequence_key.is_none() {
+            return Err(py_err(format!(
+                "assignment scalar group `{}` declares same_value_conflict_field but no sequence_key",
+                group.name
+            )));
+        }
     }
     Ok(())
 }

{solverforge-0.6.5 → solverforge-0.6.7}/src/state/marshal.rs

@@ -436,6 +436,9 @@ fn row_metadata_fields(schema: &DynamicSchema) -> BTreeSet<String> {
                 field_names.insert(field.clone());
             }
         }
+        if let Some(field) = group.same_value_conflict_field.as_ref() {
+            field_names.insert(field.clone());
+        }
     }
     field_names
 }
@@ -499,10 +502,12 @@ fn validate_assignment_group_field_metadata(
             .sequence_key
             .as_ref()
             .and_then(MetadataSourceSchema::row);
+        let same_value_conflict_field = group.same_value_conflict_field.as_deref();
         if required_field.is_none()
             && capacity_field.is_none()
             && position_field.is_none()
             && sequence_field.is_none()
+            && same_value_conflict_field.is_none()
         {
             continue;
         }
@@ -560,6 +565,35 @@ fn validate_assignment_group_field_metadata(
                     )));
                 }
             }
+            if let Some(field) = same_value_conflict_field {
+                let value = assignment_metadata_field(row, &group.name, row_index, field)?;
+                let DynamicValue::List(conflicts) = value else {
+                    return Err(crate::error::py_err(format!(
+                        "assignment scalar group `{}` field `{field}` on row {row_index} must be a list of entity indices",
+                        group.name
+                    )));
+                };
+                for conflict in conflicts {
+                    let DynamicValue::Int(conflict) = conflict else {
+                        return Err(crate::error::py_err(format!(
+                            "assignment scalar group `{}` field `{field}` on row {row_index} must contain only entity indices",
+                            group.name
+                        )));
+                    };
+                    let Ok(conflict) = usize::try_from(*conflict) else {
+                        return Err(crate::error::py_err(format!(
+                            "assignment scalar group `{}` field `{field}` on row {row_index} contains invalid entity index {conflict}",
+                            group.name
+                        )));
+                    };
+                    if conflict >= rows.len() {
+                        return Err(crate::error::py_err(format!(
+                            "assignment scalar group `{}` field `{field}` on row {row_index} contains out-of-range entity index {conflict}",
+                            group.name
+                        )));
+                    }
+                }
+            }
             if let Some(field) = capacity_field {
                 let value = assignment_metadata_field(row, &group.name, row_index, field)?;
                 let DynamicValue::List(values) = value else {

{solverforge-0.6.5 → solverforge-0.6.7}/src/state/solution.rs

@@ -671,10 +671,19 @@ impl DynamicModelBackend for PyDynamicSolution {
     fn scalar_value_is_legal(
         &self,
         entity: EntityClassId,
-        _row: usize,
+        row: usize,
         variable: VariableId,
         value: usize,
     ) -> bool {
+        if let Some(candidates) = self
+            .state
+            .entities
+            .get(entity.0)
+            .and_then(|rows| rows.get(row))
+            .and_then(|row| row.candidates_at(variable.0))
+        {
+            return candidates.contains(&value);
+        }
         self.state
             .scalar_value_range_at(entity.0, variable.0)
             .is_some_and(|values| values.contains(&value))