Method _resolve_instance

relay/instance_registry.py:438–452

Resolve an instance by 5-stage matching. Priority: ref_id → exact id → exact name → path suffix → name prefix. Each stage: 1 match → return, multiple → AmbiguousInstanceError, 0 → next.

(self, query: str)

        return self._unique_match([i for i in all_inst if i.project_name.startswith(query)], query)

    def _resolve_instance(self, query: str) -> UnityInstance | None:
        """Resolve an instance by 5-stage matching.

        Priority: ref_id → exact id → exact name → path suffix → name prefix.
        Each stage: 1 match → return, multiple → AmbiguousInstanceError, 0 → next.
        """
        ref_match = self._resolve_by_ref_id(query)
        if ref_match:
            return ref_match

        exact = self._instances.get(query)
        if exact:
            return exact

        return self._fuzzy_match(query)

    def get_instance_for_request(self, instance_id: str | None = None) -> UnityInstance | None:
        """Get the instance to handle a request.